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I TERMINOLOGY AND ABBREVIATIONS I SECTION I I 



< 



1.1 TERMINOLOGY 



1.2 Data Communications System 

Viewed in its most elementary aspect, a data communications system 
consists of (1) a central computer (CPU) and associated transmission 
control equipment, (2) remote stations, and (3) the communications 
lines that connect the remote stations to the CPU. 

Typically, the transmission control equipment Is called a transmission 
control unit (TCU). TCU's are generally attached directly to a channel 
of the CPU. In the case of a 3000 CPU, examples of a TCU are the HSI, 
SSLC, and SCCP boards (described later). 

C^The equipment constituting a remote station can be either a terminal or 

another CPU. A terminal consists of a control unit and one or more 

input/output devices, each of which is called a component of that 
terminal. 

It is the method of connection to the CPU, rather than the distance 
from the CPU, that determines whether a station is classified as 
remote. A station is considered remote if it is connected to the CPU 
through a TCU. A station connected directly to a data channel of a CPU 
is termed a local station. In general, data communications software 
concerns itself with remote stations only. 



1.3 switched/Non-Switched 






A non-switched (dedicated) line is one that continuously links the 
stations associated with it, regardless of the amount of time it is in 
use for message traffic. This type of line could connect a terminal 
physically located near the CPU, but usually it is a line provided by a 
common carrier on a contractual basis in order to service a distant 
station. A switched line is one in which an electrical connection 
between the CPU and a remote station is established by dialing. As in 
the public telephone network, the actual communication path for a given 
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transmission via a switched line Is not fixed but is automatica 
selected from a variety of possible paths by common carrier switch 
equipment. 



iP 



Each remote station on a switched line is continuously connected to a 
common carrier switching center (exchange) by an access line in the 
same way as a telephone. Similarly, each TCI) at the central computer 
is connected to an exchange by access lines. Usually, a TCU has 
several access lines, each with its own telephone number. 

Common carriers usually charge for switched lines on a time-used basis 
rather than a contractual basis. 



1.4 Point-to«Point/Multi-Point 

h line is called point-to-point if it connects the computer to a single 
remote station? it is multi-point if more than one remote station is 
connected to the line. (Multi-point is often called multi-drop.) 

See Figure 1.1 for a general overview of line and station 
configurations. 



i.5 Duplex/Half-Duplex/Simplex 

ai tis m» mt tutim ^ »m m» mt fm mum mt wt mt mtnt tm an wm m ^m m m ^m 

The term duplex (or full-duplex) is applied to a communications line 
that can accommodate data transmission in both directions at once. 
Half-duplex lines permit transmission in only one direction at a time; 
the line may be used to both transmit and receive data, but not 
simultaneously. To allow the direction of data flow to be reversed, all 
traffic is stopped for some period of time. This quiescent interval is 
called the turn-around time. Duplex and half-duplex lines accommodate 
bidirectional communication; a simplex line is unidirectional. 

switched lines which use a one phone connection are constrained to be 
half duplex if they're operating at line speeds in excess of 1200 
bits/second because the lines are two-wire and do not have sufficient 
bandwidth to allow full duplex operation. Two phone connections allow 
full duplex operation in a dial up mode. Nonswitched lines are usually 
full duplex. 



C J 
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FIGURE 1.1 Line and Station Configurations 
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1,6 synchronous/Asynchronous Transmission 



jjiP»t^ 



Basically, there are two distinct methods by which data are transmitted 
over communications lines: 

a) synchronous communication Is used for high-speed data transmission 
between the CPU and another remote computer or high-speed terminal, 

b) asynchronous communication Is used for data transmission at lower 
speeds between the CPU and remote terminals of various types. 

Asynchronous transmission uses start and stop bits to separate one 
character from another. Synchronous transmission does not use 
start-stop bits and thereby permits more Information to be passed over 
a circuit during a given time Interval. 

Although there are exceptions, a synchronous station Is generally 
another CPU or a page-mode terminal which may have high speed 
components ll)ce a card reader, printer, magnetic tape drive, etc. On 
the other hand, an asynchronous terminal is usually a low-speed device 
with a keyboard. 

1.7 Two-way Alternate/Two-way Simultaneous 



A Two-way Alternate (TWA) protocol can only manage data transmission In 
one direction at a time. A TWA protocol may be used on either a half or 
full duplex channel, but data will never be sent and received 
simultaneously. TWA protocol performance Is better when used on a full 
duplex Channel because the turn-around time Is minimized. 

A Two-way Simultaneous CTWS) protocol manages simultaneous data 
transmission and reception. A full duplex communications channel Is 
necessary when using a TWS protocol. 

For two-way alternate operation, IBM defined a generalized transmission 
technlgue called binary synchronous communication (BSC). B5C Is 
currently the de-facto industry standard for half-duplex synchronous 
communication. BSC accommodates a variety of transmission codes 
(EBCDIC, USASCH, Slx-Blt Transcode) as well as a transparency feature 
that allows transmission of raw binary data which has no graphic or 
control significance. BSC Is predicated on the assumption that 
transmission errors can occur? hence, much of BSC is concerned with 
error detection and correction. 

For two-way simultaneous operation, an HP developed protocol called 
HPDLC I Is used. This Is based on "Recommendation X.25j Interface 
between DTE and DCE for terminals operating In the Packet Mode oq 
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r ubilc Data Networks- as approved by CCITT (International Telephone . 

^telegraph consultative Committee). This basis was chosen since it is an 
approved standard by an international body, and is a subset ot both 
ANSI's current ADCCP recommendation and ISO HDLC recommendation. 



8 Modes 



Any given BSC line in a communications network operates in one of two 

modes: 

a) Contention Mode 






^F^ 



For point-to-point lines (switched and non-switched), the two 
stations are often symmetrical with neither having control of the 
line or the other station. The two stations contend for the line by 
bidding to become the transmitter. To provide for the situation in 
which both stations bid simultaneously, one of the stations is 
denoted the primary while the other Is the secondary station. The 
primary station will persist in bidding while the secondary relents. 

Contention mode is never applicable to multi-point lines. 

^) Supervised Mode 



This mode is required to operate on either switched or non-switched 
multi-point lines. On a line operating in supervised mode, there is 
always one control station; each of the remaining stations is a 
tributary station. The control station (normally a CPU) is the 
master, and the tributaries are slaves. 

The control station "polls" the tributary to solicit input, and it 
"selects" the tributary for output. 

HPDLC I makes use of two-way simultaneous communications with 
unbalanced, symmetrical stations operating in Asynchronous Response 
Mode, "symmetrical, unbalanced stations" is a term denoting the fact 
that each station contains a primary function responsible for 
sending data and control and a secondary function responsible for 
receiving data and control. The secondary function also makes 
positive and negative acknowledgements of the data received. The 
primary function In one station transmits to the secondary function 
in the other station. "Asynchronous Response Mode" means that a 
secondary function can transmit at the earliest opportunity without 
any prompting by its corresponding primary function. Since this is a 
two-way simultaneous protocol, this opportunity is always available. 
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1.9 Addressing 

a) Components 



o 



A component (I/O device) of a station is either input-only, 
output-only, or input/output. A station may have multiple 
components. 

on all contention lines and most modern multipoint lines, the 
components of a multi-component station are uniquely identified via 
component addresses within the transmitted text. However on 
supervised lines containing relatively old tributaries, such as IBM 
2780 RJE; terminals, the components are directly addressed in the 
polling and selection sequences. 

b) Terminal Groups. 



Most modern multipoint tributary terminals are attached to the line 
in groups. This enables a hardware cost savings since only one 
modem and one set of polling/selection decoding electronics are 
needed per group, switched lines may have more than one groupr^^ 
however, all of the members of any particular group must snare thi ■ 
same line. Nonswitched line may have an unlimited number. i^->^ 
general polling or selecting tributary groups requires a three field 
sequence: 
1> group ID 

2. station ID 

3. component ID 

CS logically assumes that all multipoint lines always use the full 

three field sequence. However it is quite rare that this would 

actually happen. Usually the line will fall into one of three 

possible configurations. Their characteristics and CS conventions 

are: 

CD Only station IDs are used. 

All stations logically belong to one group whose group ID is 

null. Each station has one component whose ID is null. 
C2) Only group and station IDs are used. 

Each station has one component whose ID is null. 
(3) Only station and component IDs are used. 

All stations logically belong to one qroup whose group ID is 

null. 

An additional CS convention is that when configuring the line, the 
station ID is not explicitly specified. It must be embedded into 
each of the station's component IDs. ^r^ 

O 
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There are two additional advantages that terminal groups ofter: 
1, General Poll. 



The control station may invoice general poll (sometimes called 
"group poll") by sending: 

(a) group ID 

(b) general poll ID 

This allows any or all terminals in the group, having data to 
send, to respond. The electronics within the group insures that 
the polling proceeds in an orderly manner; that is, only one 
tributary at a time actually sends text and after the last 
tributary has finished, a special seguence is sent to the control 
station notifying it that there are no more terminals having data 
to send. Tributaries are required to place their station IDs at 
the beginning of their sent text so that the control station may 
identify the origin of the incoming data. 

The advantage of general poll is that it eliminates the overhead 
and delay of having to sequentially poll each terminal, 

2. General select. 



This facility, sometimes called "group broadcast", enables the 
control station to broadcast a text block to all terminals 
attached to a group. No acknowledgement to the text is returned 
by the group or any of its terminals. The HP 2645 terminal also 
has line select which broadcasts text to all terminals on the 
line in a similar fashion. 



1. 10 Identification Sequences 

To provide validation and security for the use of both switched and 
nonswitched lines, ID sequence verification is used, (This facility is 
not used by all protocols; for example, it is used by the BSC protocol, 
but not by the HPDLC I protocol.) To use this facility, each remote 
station that is permitted to access the computer over the line must 
have an ID sequence that it automatically sends immediately after the 
line connection has been established. The program compares the received 
seguence against a list of permissible sequences. If a match is found, 
message transmission can proceed. Otherwise, the connection will be 
broken. 
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1.11 Concurrent vs. Non-concurrent Input/Output /^ 

m data communications, there Is a requirement tor multiple lines to be 
controlled by a single application or process. This requirement, in 
turn, dictates the need for I/O requests to return to the caller 
without waiting for completion. To satisfy this requirement, CS 
provides two basic forms of I/O support; 

1) I/O requests with an implicit wait. This mode will be called non- 
concurrent input/output (NCIO), because I/O is not done concurrently 
with the execution of the user's program. 

2) I/O requests without wait, requiring the user to subsequently issue 
an explicit wait request. This mode will be called concurrent 
input/output (CIO), because I/O is performed concurrently with the 
execution of the user's program. 



1.12 ABBREVIATIONS 

The following abbreviations are used throughout the remainder of this 
document: 

BSC - Binary Synchronous Communication ^>^ 

CIO - Concurrent Input/Output 

CS - MPE Communications System (CS/3000) 

DCE - Data Communications Equipment 

The equipment installed at the user's site which (a) provides 
all the functions required to establish, maintain, and terminate 
a connection, (b) the signal conversion coding between the data 
terminating equipment (DTE) and the common carrier's line, e.g., 
data set, modem, DCE is also used to refer to the network side 
of a network/terminal interface on a PACKET MODE PUBLIC DATA 
NETWORK. 

DTE • Data Terminating Equipment 

Any piece of equipment at which a communications path begins or 
ends, e.g., a terminal or computer, DTE is also used to refer to 
the terminal side of a network/terminal interface on a PUBLIC 
MODE PUBLIC DATA NETWORK. 

rs - MPE File system 

HPDLC I- HP Data LinK Control ( a Tws protocol ) 

HSI - HP 30360A Hardwired Serial Interface 

ID - ID sequence. Additionally it refers to a field of a polling or 
selection sequence for a multipoint tributary. 

MP ^ Multi-point (also called multi-drop) 

NCIO • Non-Concurrent Input/Output 

NSW « Non-switched 
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\ P - Point-to-point 

SCCP -HP 30010A (or 30020A) Single Channel Communications Processor 

SDLC - Synchronous Data Link Control 

SSLC - HP 30055A Synchronous Sinqle Line Controller 

SW - switched 

TCU - Transmission Control Unit (an HSI, SSLC, or SCCP) 

TWA - Two way alternate transmission 

Tws - Two way simultaneous transmission 



o 
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I I 

INTPODUCING CS/3000 I Section II I 

i i 




CS/3000 provides the MPe user with a basic and flexible set of tools 
for the control of communications lines and terminals. The system is 
designed to satisfy the communications I/n requirements of both the 
ordinary user and the more sophisticated user. These requirements are 
met by providing a flexible set of user-callable intrinsics, each of 
which performs a specific communications function. 

If CS is installed and communication lines are configured, a minimum of 
64K words of main memory is required. In addition, CS requires at 
least one of the following hardware components: 

1) HP 30055A Synchronous Single Line Controller (SSLC) 

2) HP 30360A Hardware Serial Interface (HSI) 

3) HP 30010A Cor 30020A) Single Channel Communications Processor (SCCP) 

The SSLC is a control unit which accommodates one synchronous line and 
is the mechanism for communication with other CPU's or synchronous 
terminals using the BSC or Conversational BSC protocol. The HSI is a 
ontrol unit which provides a means of high speed communication between 
P CPUS, The SCCP is a control unit which supports both synchronous and 
asynchronous lines, and provides a variety of user-specified protocols. 

CS/3000 consists of a set of drivers and user-callable intrinsics. As 
such, CS is not a runnabie subsystem but rather a set of primitives 
which facilitate the development of data communications applications. 

CS will support SSLC, HSI, and SCCP lines; the MPE file system (FS) 
supports all of the standard peripherals plus a special form of 
asynchronous terminal support for log-on terminals. The device types 
supported by CS are 

type 17 - SCCP permanently allocated to CS 
type 18 - SSLC permanently allocated to CS 
type 19 - HSI permanently allocated to CS 

All of the standard MPK peripherals will be permanently assigned to FS; 
SSLC, HSI, and SCCP lines will be permanently assigned to CS. 
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2.1 INTRINSICS 



o 



CS intrlnslcs begin with the letter "C" and, with few exceptiohs, are 
analogous In both name and function to FS Intrlnslcs, The primary 
distinction between FS and CS Is that FS presents a device-Independent 
Interface to the application program whereas the CS Interface Is 
device-dependent. The same set of CS Intrlnslcs applies to all device 
types supported by CS, 

Depending upon whether a device Is permanently assigned to CS or FS, 
the method of access Is restricted to either the "C" or "F" Intrlnslcs, 
respectively, never a mixture, 

FOPgM parameters may be supplied (or overridden) from an external 
source at execution time via the ;FILE command, CS provides the 
analogous facility for the COPEN Intrinsic with the jCLINE command. 
Similarly, CS provides a :CRESET command which Is analogous to the 
s RESET command of the file system. 

The FOPEN of FS returns to the caller a file number used to identify 
the opened file In subsequent FS Intrinsic calls. The COPEN of CS 
returns to the caller a line number used to identify the opened line in 
subsequent CS intrinsic calls, within a single process, FS file 
numbers and CS line numbers are unambiguous, 

unlike the FS, which permits multiple FOPENs of a single file, CS wil 
permit only one COPEN for a given line. 



2.2 CAPABILITY 

Due to the limited number of hardware resources supported by CS, the 
user (not the program) must have a special capability in order to COPEN 
a CS line. The user attribute '•CS" has been added to the jnEWACCT, 
SALTACCT, SNEWUSER, and SALTUSER commands. This capability will be 
reflected by a "1" in bit (13sl) of word in the CAPABILITY parameter 
of the WHO intrinsic. 
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)s/3000 HAHDWARK COMPONfcMS 



,4 HP 30360A Hardwired Serial Interface (HSI) 

One HSI board occupies one slot on the multiplex channel (30035). An 
HSI cannot be attached to a selector channel (30030). 

Each HSI board can accommodate up to 4 distinct lines, only one of 
which may be open at any given time. Physically, each of these tour 
lines must be configured as hardwired point-to-point. The data transfer- 
rate is a function of cable length; the maximum transfer rate is A.t> 
megabits per second for cables less than 1000 feet in length, 

hfOTK; Although the HSl is a high-speed device, it is actually an 
asynchronous device because each data word is surrounded by 
start-stop bits (20 bits are transmitted per data word). 

The HSI reguires a full-duplex line. 

i.si P 30055A synchronous Single Line Controller (SSLC) 

One SSLC board occupies one slot on the multiplex channel (30035). An 
SSLC cannot be attached to a selector channel (30030). 

fc:ach SSLC board accommodates one synchronous line, which is configured 
as a point-to-point contention station or as a a control station of a 
multipoint line. 

Physically, the SSLC line can either be hardwired or be connected via a 
modem. If a modem is usea, the line may be either switched or 
non-switched, and the data transfer rate is limited by the modem, if 
the SSLC lihe is hardwired, the maximum data transfer rate is 1'5200 
baud for cables less than 1000 feet in length. 



Th 



e SSLC can operate on either a half-duplex or a full-duplex line. 



>.6 HP 30010A (or 3002OA) Single Channel Communications Controller (SCCP) 

One HP 30010A SCCP board occupies two slots on the multiplex channel 
.(30035) on the HP 3000 Series II; an SCCP cannot be attached to a 
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selector channel (30030), The HP 30020A SCCP board is compatible witCj 
the HP Interface Bus (HPIB), used on the Toothpick/Amlgo systems. 

Each SCCP board accommodates one synchronous or asynchronous line, 
which may be configured as a BSC point-to-point contention station, a 
control station of a multipoint line, a conversational BSC station, or 
as a network DTE or DCp in an hpdlc I environment. 

Physically, the SCCP line can either be hardwired or be connected via a 
modem. If a modem is used, the line may either be switched or 
non*swltched, and the data transfer rate is limited by the modem, with 
a maximum speed of 56 Kbaud. if the SCCP line is hardwired, the data 
transfer rate is 56 Kbaud for cables less than 4000 feet in length. 

The SCCP board can operate on either a half-duplex or full-duplex line. 
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MAXIMUM DATA TRANSFER RATES 
Component Baud 



SCCP (xxxxx) ( 8 bits/byte) 1 ♦♦♦♦♦♦» 
(10 bits/byte) 1 
(U bits/byte) 1 

1 ^t*^*^* 


HSI (30360)(10 hits/byte) \ 

Hardwired 1 2,500,000 


SSLC (i0055)(8 bits/byte) 1 

Bell 201A Modem (SW) 1 2,000 
Bell 201B Modem (NSW) 1 2,400 
Bell 208A Modem (NSW) 1 4,800 
Bell 208B Modem (Sw) 1 4,800 
Bell 209A Modem (NSW) 1 9,600 



DRIVERS AND LINE PROTOCOLS 






\act\ type of line supported by CS requires a ditferent driver. The 
hardware board and the line protocol dictate how the driver is written. 

Lines using either the SSLC or the HSI will employ the BSC protocol, 
which is widely used by the manufacturers of other CPUs and terminals. 
Since the BSC protocol may dlso be used with the SCCP board, the user's 
application program can be relatively independent of whether a line is 
SSLC, HSI, or SCCP. 

A full enumeration of the protocol drivers provided by CS are: 
BSC driver for use with contention SSLC lines, 
BSC driver for HSI contention lines, 
BSC driver for SCCP contention lines. 



driver to enable the 
of BSC tributaries 

driver to enable the 
the SSLC or SCCP. 

driver to enable the 
SCCP. 

driver to enable the 



3000 
such 
3000 



to 
as 
to 



control a multipoint SSLC line consisting 

the HP 2645. 

emulate a HASP Workstation (mrje) using 



JOOO to emulate an IBM 3270 workstation using the 

i full-duplex 



3000 to operate as a DTE or DCE in 
mode, using the HPDLC I protocol on SCCP. 
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2.8 SUPPORTED LINE CONFIGURATIONS 



o 



For all CS line types (SSLC, HSI, and SCCP), the following line 
configurations will be supported: 

1) non*swltched, point-to-point lines 

NOTE: Each of the four HSI ports may be physically connected to a 
different remote station, but only one may be selected by any 
given COPEN, in other words, no more than one HSI port should 
foe configured per logical device number for point-to-point 
operation. 

For the SSLC and SCCP line types the following line configurations 
will be supported: 

S) switched, point-to-point lines 

2} non-switched, multipoint lines In which the 3000 Is the control 

station. 

3) switched, multipoint lines In which the 3000 Is the control 

station. ^-^ 

() 
The SCCP board will also support the following line configurations; 

1) non-switched, multipoint lines In which the 3000 Is a tributary 
(secondary) station 

2) switched, multipoint lines In which the 3000 Is a tributary 
(secondary) station 

3) switched lines In which the 3000 is acting as a DTE m a TWS 
environment 

4) non-switched lines In which the 3000 Is acting as a DTE In a Tws 
environment 

5) switched lines In which the 3000 Is actln as a DCE in a TWS 
environment 

6) non-switched lines In which the 3000 Is acting as a DCE In a TWs 
environment 
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( OPERATING CS/3000 I Section III I 
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3,1 MISCELLANEOUS COMMAND EXTENSIONS 

The following standard MPE commands have been extended to accommodate 
CSJ 

:NEWACCT 
:ALTACCT 
:NEWUSER 

:altuser 

The user attribute •'CS" may be specified in the <capabiXitylist> of the 
above commands. 



3.2 USER COMMANDS 



^""^^ 



£^\ 



Two user commands are defined for CS, namely :CLINE and sCRESET. A user 
must have CS capability to use these commands; a capability error will 
result otherwise. 



3.3 5CLINE Command 



The purpose of the :CLINE command is to: 

1) Enable programs to reference lines without knowledge of their actual 
logical device numbers. 

2) Enable a user to make detailed line specifications at run time, as 
overrides to any corresponding specifications that may have been 
made in COPEN intrinsic calls at compile time. 

Within a program, a line may be referenced indirectly in a COPEN 
intrinsic call via a "formal line! designator" which is a name 
associated at run time with a specific :CLINE command. 
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For user pre-defined lines: I^ 

sCLINE formaldesignator s*f ormaldesignatorl 

For new lines? 

sCLINE torroaldesignator 

C?DEV»device3 

C?BUFstnumbuffers3 C,buffsize3 ] 

n 

BSG 
CiPROTOs: MRJE ] 
HPDLCI 

n 

SEMSE 
CiCODEs EBCDIC 3 
ASCII 

HIGH 
[; DUALS 3 
LOW 



o 



w 

C;DIAL« RW 3 
NO 

n 
r?LMODEs PRI 3 
SEC 
MPCNT 
MPSEC 
DTE 
DCE 

C?DRIVER»drivernawe3 

£?D0PTI0NScn3 

CjSPEEDs inspeedC,outspeed3 3 

C?L0CIDsidsequence3 

lFREMIDsidsequencet,idsequence3 ...3 

C;PHLIST5sphonenumber t ,phonenurober3 • • • 3 
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r;MISC=c,i[C,13...1 ,[c,i[C,i] ...] J ,.•.] 
C;DOWNFILE=fllename] ♦*♦♦♦ not implemented yet ♦»♦♦ 

; TRACE [sCALLJ [ , [mask] C , tnumentries] t , WPAP] }] 3 
NOTRACE 

; ID 
NOID 

; TIMEOUTS 
NOTIMEOIJTS 

t;SUPLIST= general suplist J ♦♦ not implemented ♦♦ 

r;POLLIST= pollentry [ ,pollentryJ • . • J ♦ not implemented * 



where 

A "string" 
E 
♦ id sequences 

(dt,d3...) 

\ H 






♦string - string of characters with "" representing ". 

377 

♦ d • octal (or hexadecimal) specification of 1 byte (0<=d<s: FF ) 

(A=ASCII, E=EBCDIC, O=octal, H=hexadecimal) 

♦ "n" is an integer whose value is the encoded representation of the 
corresponding field in the AOPTIONS, COPTIONS, or doptuins 
parameter of COPEN. 

♦ c, i - integers where 

c is an integer defining the parameter type 

i is an integer specifying the value of the parameter. 

see the COPEN intrinsic specification for the permissible values of 
c, 

♦ Filename is the name of the file which contains the default 
protocol driver information and the download records for the SCCP 
protocol driver. This parameter is ignored for SSLC and HSI 
devices. 
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♦ "ALL" will generate trace records for all CREAD, CWRITE, and 
CCONTROL requests. If "ALL" is not specified, then trace records 
will be written only when a CREAD, CWRITE or CCONTROL completes 
with a transmission error. 

» Mask may be a decimal integer or an octal integer preceded by a 
percent sign. 

♦ WRAP specifies that succeeding trace entries may be written over 
previous entries if there is no more space in the trace record. The 
default is NOWRAP. 

♦ Numentries must be a decimal integer. 

♦ general suplistamplinetype C,LSELsss3 CGRPsgdesc] C,GRP«gdesc3 ... 

^ mplinetype is a positive integer specifying the type of stations on 
a multipoint line, if no other field appears in the SUPLIST 
parameter, then "self-configuring" mode is assumed (see description 
of byte of the SUPLIST parameter in the COPEN intrinsic for a 
more detailed explanation). 

LSEL is the line's line selection sequence. 

o 

Gdesc describes the attributes of a multipoint terminal group. 

PS ps 

gdescsCIDs ps.ss ,3 [GENs ps,ss ,] STAssdesc ( ,STA=sdescl . . . 

f ss , ss 

ID is the group polling/selecting ID. 

GEN is the general poll/selection ID. 

Ps is the polling sequence ID. 

Ss is the selection sequence ID. 

A "string" 
ps E 

ss (dCrd)...) 

H 

Sdesc describes the attributes of a station attached 
to a multipoint terminal group. 



sdesc=Ctype) , Cbuffslze), cdesc t^cdesO... 
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Type is an integer whose value may be from 
to 255. 

Buftsize is the station's output bloclcsize. If 
this parameter is omitted, then the line's buffsize 
will be used. 

Cdesc describes the polling and selection IDs of a 
component attached to a multipoint tributary station. 

cdesc=tpsj C,ss)l 

Note that CS assigns successive logical group numbers to each ^ro^P 
defined in the SUPLIST parameter, beginning with one for the first 
group defined. In a similar manner, logical station numbers are 
assigned to each station specified. Logical station numbers are 
unigue within the line. Logical component numbers are successively 
assigned to each component on a station, beginning with zero for 
the first component of a station. Logical component numbers are 
unique only within a particular station. 

Pollentry is either a terminal group or a station/component. 

Gslogical group number 
Pollentrys logical station number 

logical station number/logical component number 
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The various sCLINE parameters correspond to COPKN intrinsic call 
parameters as follows: 






:CLINE parameter 



COPfc:N Parameter 



formaldesignator 

device 

numbuf f ers 

buffsize 

PROTOs 

BSC 

MRJE 

HPDLCI 

ID 
NOID 

TIMEOUTS 
NOTIMEOUTS 



CODES 



DUALS 



DIALS 



SENSE 
ASCII 
EBCDIC 



LOW 
HIGH 



W 
R 

RW 
NO 



LMODEs 



PRI 

SEC 

MPCNT 

MPSEC 

DTE 

DCE 



contents of array FORMALDESIG 
contents of array DEVICE 
NUMBUFFERS 
BUFFSIZe 



AOPTIONS (0:8) s I 
s 2 
S3 

COPTIONS (l:l) s 

s 1 

COPTIONS (0:1) s 
COPTIONS (1:1) s 1 



COPTIONS (10:6) s 1 

s 2 
s 3 



COPTIONS (4:2) s 



AOPTIONS (12:2) s 



COPTIONS (6:4) s 



O 



o 
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drivername 

DOPTIONSsn 

TRACES.., 

inspeed 

outspeed 

LOCID=idsequence 

REMIDsldsequence, ... 

PHLISTsphonenumber, • 

DOWNFILEsf ilename 

SUPLISTs... 

POLLISTs... 



contents of array DRIVERNAME 

DOPTIONS 

CTRACEINFO 

INSPEED 

OUTSPEED 

local id sequence in array IDLIST 

remote id sequences in array IDLIST 

phonenumbers in array PHONELIST 

c: MISCARRAY parameter type code 
i; parameter value 

Contents of the array DWNLDFILE. 

SUPLIST parameter 

POLLIST parameter 



c 
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3.4 sCRESET Command 



o 



This command Is the CS analog to the file system :RESET command. It 
allows the user to nullify any previous :CLINE command referencing the 
formal line designator. The format of the :CRESET command is 

formaldesignator 
:CRESET 

formaldesignator - The formal line designator to be reset. 

@ * An indication that the formal line designators 

referenced in all prior ;CLINE commands in the 
job/session are to be reset. 

(Either the formaldesignator or (a must be entered.) 



3.5 USER MESSAGES 

The :CLIME command may cause the following CS^specific errors? 
Error # Message 



800 CLINE EQUATION TABLE FULL 

801 PACK CLINE REFERENCE NOT FOUND 

802 TOO MANY BACK CLINE REFERENCES 

803 INVALID CLINE DESIGNATOR 

805 NAME MISSING 

806 EMBEDDED SPECIALS IN PROPER NAME 

807 NAME BEGINS WITH NUMERIC 

808 NAME LONGER THAN 8 CHARACTERS 

809 EQUAL SIGN EXPECTED 

810 VALUE NOT OPTIONAL 

812 BINARY FAILED ON INTEGER 

813 INTEGER EXCEEDS 377 

814 COLON EXPECTED 

815 KEYWORD EXPECTED 

816 DEVICE NAME EXCEEDS 8 CHARACTERS 

817 REDUNDANT KEYWORD 

818 INTEGER EXCEEDS 63 
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(819 INTEGER EXCEEDS 15 

820 DRIVER NAME LONGER THAN 8 CHARACTERS 

821 INTEGER EXCEEDS 127 

822 LINE NAME REQUIRED 

823 ACTUAL LINE DESIGNATOR REQUIRED 

824 BACK REFERENCE WITH PARAMETERS IS ILLEGAL 

The following warning message may also appear In conjunction with the 
:CRESET command: 

804 CLINE EQUATION NOT FOUND 

401 CRESET PARAMETER ERROR 
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I USING CS/3000 INTRINSICS I Section IV I 
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4.1 GENERAL DESCRIPTION 

Within a user's program, the accessing of and communication with remote 
devices is accomplished through CS intrinsic calls. The remote/line 
relationship is somewhat analogous to the file/device relationship 
existing in the file system. The line is the primary link between the 
user and CS; each line referenced is first opened through the COPEN 
Intrinsic call. Then, other operations such as reading, writing, and 
line control can be performed with other line intrinsic calls. The 
line is closed through the CCLOSE intrinsic call, issued by the user's 
process or by MPE/3000 when the user's process terminates. 

In the COPEN intrinsic call, the user references a particular line by 
its formal line designator. When the COPEN intrinsic is executed, it 
returns to the user's process a line number by which the system 
uniquely identifies the line. This line number is also unique with 
respect to file numbers as managed by the file system. The line number, 
rather than the line designator, is used by subsequent intrinsics in 
referencing the line. 

The condition codes returned to the user's program by the CS intrinsics 
have the following general meanings. The specific meanings, of course, 
depend on the intrinsic: 

Condition Code Meaning 



^fim^^ 






CCE The function requested by the intrinsic call was 

completed successfully. 

CCG Variable, intrinsic-dependent. 

CCL The function requested by the intrinsic call 

terminated with an error or an abnormal condition; 
corrective action may, in some cases, be taken. (By 
issuing a CCHECK intrinsic call, the user can have a 
more detailed error description returned to his 
process.) 

It should be noted that DB must point to the user's process' stack for 
all COPEN and CGETINFO intrinsic calls. 
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For the intrinsic descriptions to follow, all parameters are required 
unless otherwise noted; all bit fields marlced for future use should be 
set to zero by the user. 



o 
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i3PE;NING LINES 

The COPEN intrinsic opens a data communications line. Before a user's 
process can communicate with a remote device, the process must initiate 
access to the line, of which the remote device is a part, by opening it 
through a COPEN intrinsic call. The intrinsic returns to the user's 
process a line number which is used to identify the line in subsequent 
CS intrinsic calls. 

If the line is opened successfully (i.e., the CCE condition code is 

returned), the line number returned is a positive integer ranging from 

1 to 255. If the line cannot be opened (i.e., the GCL condition code 
is returned), the line number returned is zero. 

In opening a line, COPEN establishes a communication linJc between the 
line and the user's program by 

1. Allocating exclusively to the user's process the desired line. Once 
allocated, the line may not be opened or accessed by any other 
process in the user's job/session or by any other program until the 
opening process has issued a close request (CCLOSE intrinsic call). 
Thus, exclusive access to the line is always assumed. The process 
causing the open must not attempt to open the line more than once 

s unless corresponding close requests have been issued. 

2. Constructing the control blocks required by MPE/3000 for this 
particular access to the line. The information in these blocks is 
derived by merging specifications from the following sources, listed 
below in descending order of precedence: 

a. The non-overridable information contained in CONFIGURATOR - 
generated CS tables. This information overrides that from any 
other source, 

b. The parameter list of a previous :CLINE command referencing the 
same formal line designator name in the COPEN call, if such a 
command was Issued in this job or session. This information 
overrides that from the three sources below. 

c. The parameter list of the COPEN call, 

d. The overridable Information contained in CONFIGURATOR- generated 
CS tables. 

When information in one of these sources conflicts with that in 
another, preempting takes place according to the order of precedence 
shown above. To determine the specifications actually talcing effect, 
the user can call the CGETINFO intrinsic described later in this 
,^ection. 
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The COPEN intrinsic declaration is as follows: 

INTEGER PROCEDURE COPEN (FORMALDESIG, DEVICE, COPTIONS, AOPTIONS, 
DOPTIONS, NUMBUFFERS, BUFFSIZE, IDLIST, SUPLIST, POLliIST, 
Dk^NLDFILE, YYY, PHONELIST, INSPEED, OUTSPEED, MISCARRAY^ 
DRIVERNAME, CTRACEINFO); 

VALUE coptions, aoptions, doptions, numbuffers, buffsize, yyy, 

INSPEED, OUTSPEED, CTRACEINFO; 
hYTE ARRAY FORMAJiDESIG, DEVICE, IDLIST, SUPLIST/ PHONELIST, DWNLDFILE, 

DRIVERNAME? 
LOGICAL COPTIONS/ AOPTIONS, D0PTI0N5, CTRACEINFO; 
INTEGER NUMBUFFERS, BUFFSIZE, YYY; 
LOGICAL ARRAY POLLIST, MISCARRAY; 
DOUBLE INSPEED, OUTSPEED; 
OPTION VARIABLE, EXTERNAL; 

This intrinsic returns (as the value of COPEN) an integer line number 
used to identify the opened line in other CS intrinsic calls. If the 
line was not opened successfully, a zero is returned. It should be 
noted that within a single process, CS line numbers and file system 
file numbers are unique. 

The condition codes for the COPEN intrinsic are as follows: 

CCE - Request granted; the line was opened. 

CCG - Not returned (reserved for future use). 

CCL - Request denied. 

The COPEN request will fail if the user does not have CS capability. 

The COPEN intrinsic parameters specify the elements shown below. Either 
FORMALDESIG or DEVICE must be present (they may both be present); all 
other parameters are optional. 



o 



o 



FORMALDESIG 



a byte array containing a string of ASCII characters, 
interpreted as a formal line designator. This string 
must begin with a letter, contain alphanumeric 
characters, and terminate with any non-alphanumeric 
character. Excluding the delimiter^ the string must be 
eight characters or less in length. 

If present, this string is used to search for the 
corresponding FORMALDESIG in :CLINE commands. If no 
corresponding :CLINE command has been supplied, then the 
DEVICE parameter is used to determine the device actually 
opened. If a corresponding :CLINE command is found, its 
DEV parameter (if specified) overrides the COPEN DEVICE 
parameter. This parameter may be omitted if the DEVICE 



o 
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DEVICE 



COPTIONS 



parameter is present. 

If both FORMALDESIG and DEVICE are present, then 
FORMALDESIG is tirst used to locate a corresponding 
:CLINE command, which may override the COPEN DEVICE 
parameter. 

A byte array containing a string of ASCII characters 
terminating with any non-alphanumeric character. The 
string may specify class name (up to eight alphanumeric 
characters beginning with a letter) or a logical device 
number (up to three numeric characters). 

This parameter may be omitted if FORMALDESIG is present. 
However, if it is omitted and no !CLINE command has been 
supplied, the COPEN will fail. 

A word describing the communications options associated 
with the line. This parameter may be omitted, in which 
case the default value for each field is zero. The fields 
included ares 



AOPTIONS 



Transmission code 

Mode 

Speed select 

CLINE override 

CS trace 

ID sequence verification 

Inhibit timeouts 

These fields are described on page 4-10. 

A word describing the access options associated with the 
line. This parameter may be omitted, in which case the 
default value for each field is zero. The fields included 
are: 



Wait mode 

CLINE buffer override 

Dial type 

Inhibit operator console error messages 

Protocol 

These fields are described on page 4-12. 



DOPTIONS 



'V 



A word describing driver-related options, with the 

default value for each field being zero. 

The format of DOPTIONS for the BSC SSLC driver and 
the BSC SCCP driver is described on page 4-13; 
the format for the HSI driver is on page 4-15; 
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NUMBUFFERS 



BUFFSIZE 



the format for the hpdlc I SCCP 
4-15. 



driver Is on page 



This Integer specifies the total number of buffers to be 
assigned to the line or. If buffering is not desired, the 
number of outstanding read and write requests to be 
queued. If this parameter is omitted, one buffer will be 
used for lines not using HPDLC I protocol, and two 
buffers will be used for lines using HPDLC I protocol. 

A positive value specifies the total number of buffers to 
be used. The maximum number of CS buffers allowed for a 
line using the SSLC or the HSI driver is two; for a line 
using the SCCP board it is fourteen, thus allowing read 
and write requests to be queued. For the SCCP board, the 
maximum number of requests of either type to be 
outstanding is seven, with the maximum total number being 
fourteen. 

A negative value specifies that no buffers are to be 
assigned, but that read and write requests may be queued. 
The depth of the queue is specified by the absolute value 
of NUMBUFFERS, The maximum number of read requests or 
write requests to be queued is seven; the maximum number 
of total requests to be queued is fourteen. 

A value of zero specifies that no buffering and no 
queueing is to be done. 

this integer specifies the slie of each buffer. A 
positive number denotes words; a negative number denotes 
bytes. 

This parameter represents the maximum data transfer size. 
There exist three related default values in the CS 
system: 

(Da system-defined upper bound of 4096 words on any 
transfer 

(2) an HPDLC I protocol-defined upper bound of 512 
words on any transfer 

(3) a configured, preferred buffer size for the line. 

If BUFFSIZE exceeds the upper bound, the upper bound will 
be used in place of BUFFSIZE. If BUFFSIZE is not 
specified, the configured preferred buffer size will be 
used as a default value. 



o 






For a line operating in multipoint control mode, a 
non-zero BUFFSIZE specifies the maximum block size for a 
single transmission. A request to send a block of data 



4-6 



o 



( 



IDLIST 



SUPLIST 



c 



POLLIST 






that exceeds the BUFFSIZE parameter will be reformatted 
into a series of requests with data blocks having length 
not exceeding BUFFSIZE. If data is received in blocks, an 
error will occur unless BUFFSIZE is non-zero, which 
permits the reception of data in blocks. (Specification 
that data may be read in blocks may also be made using 
the block size portion of the station field in the 
SUPLIST parameter.) 

A byte array containing ID sequences for both the local 
and the remote stations. At most 255 ID sequences may be 
specified. Note: If no remote ID sequences are 
specified, then any received ID sequence is ignored. This 
array is described on page 4-16. 

*♦♦♦ This parameter is inapplicable to, and ignored by, 
HPDLC I. 

This is a byte array describing the maximum set of 
groups, stations, and components which will be recognized 
on a multipoint line. For a line operating in multipoint 
control mode, this list describes the stations which will 
bepolled/selected by the 3000. For a line operating in 
multipoint secondary mode, this list describes the 
station or stations which will be simulated by the 3000 
when polled/selected by the control station. 

This array is used to generate a default POLLIST if the 
POLLIST parameter is omitted. This array is described on 
page 4-18. 

♦♦♦» This parameter is valid only for lines using 
multipoint control or multipoint secondary mode and is 
ignored for all other line modes. 



A word array which defines the 
line. When the local station is 
list specifies which stations 
order of polling. When the loca 
station, this list specifies 
and stations to be simulate 
description of the POLLIST 
intrinsic for the format of the 
this list whenever the STATI 
absent, if this parameter is o 
will be generated consisting 
station on the line. The defau 
to the extent that a logical 
used to poll terminal groups wh 



poll list for a multipoint 

the control station, this 

shall be polled and their 

1 station is a secondary 

the current set of groups 

d by the 3000. (See 

parameter of the CPOLLIST 

pollist.) CS will use 

ON parameter of a CREAD is 

mitted then a default list 

of component zero of each 

It list will be optimized 

group number entry will be 

ich support general poll. 
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♦♦♦♦ This parameter is valid only for lines operating in \J 
multipoint control mode and is ignored for all other 
lines. 



DMNLDFILE 



yyy 

PHONELIST 
INSPEED 



OUTSPEED 



MISCARRAY 



A byte array containi 
interpreted as the 
containing the defaul 
the download record 
string must begin wit 
characters^ slashes^ 
non-alphanumeric char 
If this parameter is 
file name of SCCPLDOl 
ignored for SSLC and 



ng a string 

formal file 
t protocol dr 
s for the SCCP 
h a letter^ 
or periods 
acter except a 
omitted, then 
.PUB. SYS" is U 
HSI devices. 



of ASCII Characters, 
designator of the file 
iver information and 

protocol driver. This 

contain alphanumeric 
and terminate with any 

slash or a period. 

the default d ownload 
sed. This parameter is 



DRIVERNAME 



(Reserved for future use.) 

A byte array specifying one or more remote phone numbers 
for a switched line, and is described on page 4-18. This 
array is ignored for non-switched lines. 

A double-word integer specifying the line input speed in 
characters per second. If the line's hardware is such 
that its output and input speeds are always the same, 
then INSPEED will be used to specify both speeds. 

A double-word integer specifying the line output speed in 
characters per second. 

A logical array containing miscellaneous CS Information. 
The fields included are: 

Receive timout 
Local timeout 
Connect timeout 
Response timeout 
Line bid timeout 
Number of error retries 
Clear-to-send delay 
Data-set-ready delay 
Transmission mode 
MMSTAT trace facility 
Poll loop delay 
Number of poll repeats 
Poll entry delay 

This array is described on page 4-20. 

A byte array containing a string of ASCII alphanumeric 
characters which are interpreted as the name of the 
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(^ desired driver for the line. The name consists of up to 

eight Characters, beginning with a letter, and followed 
by any alphanumeric characters, and terminated by a 
non-alphanumeric character. (The delimiter is not counted 
as one of the eight characters.) 

This parameter may be omitted, in which case the default 
driver for the line will be used. When specified, the 
driver must be one which was included at configuration 
time in the set of available CS drivers. 

The protocol driver must be compatible with the line 
configuration with respect to the following: 

1. linetype (see CGETINFO). 

2. local mode COPTIONS. (6:4) . 

3. protocol AOPTIONS.(0:8). 

4. transmission code. COPTIONS. (10:6). 

The driver used for the SCCP board on the 3000 is 
"lOSCCPX"; on series 33 it is "TPDUMCS". If another 
driver name beginning with the letters •*CS" is specified 
for the SCCP, the specified name is used to indicate the 
protocol driver to download, and not the mainframe 
^x driver. 

CTRACEINFO A word used to control the CS trace facility. This 
parameter is ignored if the CS trace facility bit of the 
COPTIONS word is not set. See page 4-23 for the format of 
CTRACINFO. 
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DETAILED DESCRIPTIONS OF VARIOUS COPEN PARAMETERS ^^ 



COPTIONS 

The fields of COPTIONS are defined as follows: 

(0:1) Inhibit timeouts 

» allow timeouts 
a 1 disable all timeouts 
♦*♦♦ (This field does not apply to and is 
ignored by HPDLG I,) 

(i:l) ID sequence Verification 

s allow the use of ID sequences (both 

user-supplied and configured defaults) 

» 1 inhibit the use of ID sequences. Any 
user-supplied or configured default ID 
sequences will be ignored (applies to 
both local and remote ID sequences). 

♦♦♦* (This field does not apply to, and is 
ignored by, HPDLC I.) 

(2:1) CS trace 

a do not invoice CS trace facility 
s 1 invoke CS trace facility. 

( Refer to CTRACINFO parameter on page 4-21 ) 

(3:1) :CLINE override 

= allow CLINE command override 

a 1 prohibit CLINE command override, 

(4:2) Speed Select (European modems only) 

a use configured default setting 
a 1 set speed to low speed 
a 2 set speed to high speed 
a 3 reserved for future use. Specification 
of this value will cause a COPEN error. 



O 
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(6s4) Local mode ("local" means the station at 
your end of the line) 

s use contlgured default setting 
s 1 local Is a primary contention station 
s 2 local Is a secondary contention station 
s 3 local Is a control station on a 

multipoint line, 
a 4 local Is a secondary station on a 

multipoint line. 
= 5 local Is a HPDLC I system acting as DTE 
s 6 local Is a HPDLC I system acting as DCE 
s 7-15 reserved for HP use 

A COPEN error will result if local mode is not compatible with 
either COPEN parameters or configured line values. 

(10:6) Transmission code 

s use configured default setting 

s 1 use automatic code sensing feature 

of driver 
= 2 ASCII 
s 3 EBCDIC 

s 4-63 reserved for HP use 

♦♦»♦ (Data is transparent to HPDLC I, and this 
field is Ignored when using the HPDLC 1 protocol.) 



^0^^ 
^^^y 
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AOPTIONS 

The fields of AOPTIONS are defined as follows: 

(6:8) Protocol 

= use configured default protocol 

s 1 use BSC protocol 

s 2 use MRJE protocol 

» 3 use HPDLC I protocol 

s 4-255 reserved for HP use 

A COPEN error will result if protocol is not compatible with 
configured line specifications or driver capabilities. 

(8:3) (Reserved for future use.) 

(llsl) Inhibit console operator error message 

a allow CS to print hardware error messages at the 

operator console 
=1 inhibit CS from printing hardware error messages 

at the operator console 

(12:2) Dial type 

s dial on write connect; answer on read 

connect 
a 1 answer on write connect; dial on read 

connect 
a 2 dial on write connect; dial on read 

connect 
s 3 answer on write connect; answer on 

read connect. 

(14:1) :CLIWE buffer override 

s allow rCLINE override for NUMBUFFERS 

and BUFFSIZE 
» 1 disallow buffer information override. 

(15:1) Wait mode 

a perform all I/O using NCIO. 
a 1 perform all I/O using CIO. 

Note: Only users executing in privileged mode may open a line 
with CIO and no buffering. 
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DOt-nONS 

The meaning of DOPTIONS is protocol driver-dependent. 

For the SSLC drivers and the BSC SCCP drivers, the format of DOPTIONS is 
as follows: 

(0:1) Reserved for future use 

(1:1) Delay sequence wait 

» Wait on received WACK/TTD sequences, 

1 s Do not wait on received WACK/TTD sequences. 

C2:l) Poll termination sequence 

s Before switching between stations, an RVI is transmitted 

to return the line to control mode. 

1 s Before switching between stations, an EOT is transmitted 

to return the line to control mode. 

(3:1) Control state listen mode 

= While in control state and between user requests the driver 

will listen for any control sequences from the remote. 
Receipt of a line bid will cause the line to be placed into 
text state. 

1 5 While in control state and between user requests the driver 
will ignore any control sequences from the remote. 

(4s 2) Ending sequence: 

= use BSC default (NSWssend EOT; 

SWssend DLE EOT) 

1 = send DLE EOT 

2 s send EOT 

(6:1) s the remote will not send leading graphics 
1 = expect leading graphics from the remote 

(7:1) value of USASCII block: check character (bcc) 

s VRC/LRC (non-transparent mode or transparent with header) 
CRC-16 (transparent mode with no header) 

1 = VRC/CRC-16 (non-transparent mode) 
CRC-16 (transparent mode) 

(8:1) s automatic generation of WACK 
1 s no WACK will be sent 

(9s 1) = automatic generation of TTD 
I s no TTD will be sent 
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(10:1) ITB sequences 

s DO not expect to receive ITB sequences from the remote 

station 

Note: If an ITB sequence is received, the driver will 
require a retransmission to properly receive the 
message. The driver then sets this bit to a one. 

1 « Expect ITB sequence from the remote station. 

(11:2) Message Format Word (MFW). Refer to Section 4.13 for a 
description of the MFW. 

a MFW will not be placed into received text or expected in 

sent text. CS will use an implicit MFW of 000000 for sent 
text. 

1 s MFW will not be placed into received text or expected in 

sent text. CS will use an implicit mfw of lOOOOO for sent 
text. 

2 5s MFW will be placed into received and expected in sent text. 

3 :? reserved for future use. 

Cl3sl) Reserved for future use. 

(14:2) Number of leading SYNs 

s send four leading SYNs 

1 s send eight leading SYNs ^-.^ 

2 a send twelve leading SYNs f J 

3 s send sixteen leading SYNs ^-^ 



o 



4-14 



F(n the HSI driver, the format of DOPTIONS 
Is as follows; 

(0:1) Reserved for future use 

(1:1) Delay sequence wait 

(2:1) Ignored, 

(3:1) Control state listen mode 

= While in control state and between user requests the driver 

will listen for any control sequences from the remote. Receipt 
of a line bid will cause the line to be placed into text state. 

1 = While in control state and between user requests the driver 

will ignore any control sequences from the remote, 

(4:2) Ending sequence: 

s Use BSC default (NSWssend EOT; 

SW=send DLE EOT) 

1 = send DLE EOT 

2 = send EOT 

(7:1) ignored 

:1) Automatic generation of WACK sequences: 
^ = enable 

Is disable 

(9:1) Automatic generation of TTD sequences; 

= enable 

1 s disable 

(10:3) Ignored 

(13:1) Reserved for future use 

(14:2) Ignored 



For the HPDLC I SC3 driver, the format of DOPTIONS is as follows: 

(0:8) Reserved for future use 

(8:8) Maximum number of outstanding frames. This is parameter 
K in the HPDLC I protocol, Valid values are one through 
seven. The default is seven. 



c 
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IDLIST 

IDLIST is a byte array with the following format: 

byte total number of ID sequences 

(including the zero-length IDs) 
I length of local ID sequence in bytes (may be zero) 
2*n local ID sequence (null if length =0) 
n+1 length of remote ID sequence in bytes (may be zero) 
(nf2)«p remote ID sequence (null if length =0). 

Repeat the last ti«ro fields for each remote ID. 

The length of an ID sequence may vary from zero (meaning a null ID 
sequence) to sixteen bytes. If a remote station is not capable of sending 
an ID sequence, then the local ID sequence length should be zero? if none 
of the remote stations can transmit an ID sequence, the remote ID sequence 
should be zero* 



PHONELIST jr^ 

1 } 

Phonelist is a byte array with the following format: \^ 

byte number of phone numbers (binary) 

1 length of first phone number (binary) 

2-n first phone number (ASCII numeric with embedded *'dashes") 

Each successive phone number is specified by repeating the last two 
fields. A phone number consists of from 1 to 20 characters (ASCII 
numerics with embedded ^dashes"). 

This parameter is ignored if the line is non-switched. When operating in a 
switched full-duplex environment, there may be two phones. If there are 
two phones, CS will access the phone list in pairs, i.e., two dial 
messages will be issued when necessary. The specification of two phones is 
done at system configuration time. 
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LIST 

LIST is a byte array with the following format; 

leld one a Line field. This must be the first field of the SUPLIST. 

Byte Multipoint Line Type 

(This byte reserved for future use.) 
Byte 1 Line Descriptor 

(0j5) Reserved for future use. 

C5s2) ID Verification 

a NO ID verification will be performed. 

1 s initiate the sending of ID sequences and, when 

the remote's ID sequence has been successfully 
verified, send an EOT sequence. 

2s Allow the remote to initiate the sending of ID 
sequences. 

3 s This value is undefined. CS will reset the 

field to a zero. 
(7sl ) Line selection 

= The configuration does not support line 

selection. 

CI r The configuration has the line selection 
facility. 
Byte 2 This byte is ignored. 
Byte 3 Number of remote groups. 
Byte 4 Length of line selection sequence. 

Note: This parameter and the next one should be present 
if and only if bit (7sl) of the line descriptor 
specifies line selection. 
Byte 5-n Line selection sequence (null if lengthsO). 

ield two s Group field. Repeateo for each group attached to the line. 
COPEN assigns successive logical group numbers to each 
group defined for the line, beginning with I for the first 
group specified. 

Byte Group descriptor 

(Ojb) Reserved for future use, 
(6;1) s NO general select facility 

1 s This group has the general select capability 
(7:1) s NO general poll facility 

1 s This group has the general poll facility 
Byte 1 Number of stations in this group. 

Byte 2 Length of the group ID portion of the polling sequence. 
A value of zero is valid, 
te 3-k Group ID portion of the polling sequence (null if 
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Byte 
Byte 
Byte 



Byte 
Byte 



(lc+2)-m 
(tn+l) 



(m+2)-n 
(nfl) 



Byte (n-^a)-? 



lengthsO). 
Length of 
A value of 
Group ID 
lengthsO). 
Length of 
Note: This 
If 

spec 
General po 
Length of 
sequence. 
Note: This 
if 

spec 
General se 



the group ID portion of the selection sequence, 
zero is valid, 
portion of the selection sequence (null if 

general poll portion of the polling sequence, 

parameter and the next one should be present 
and only if bit (7:1) of the group descriptor 
ifies general polling, 
11 sequence (null if length s O), 
general selection portion of the selection 

parameter and the next one should be present 
and only if bit (6:1) of the group descriptor 
ifies general selection, 
lection sequence (null if length « o). 



o 



Field three s 



Byte 



Byte 1 
Bytes 2«3 



Station field. Repeated for each station in the group, 
COPEN assigns successive logical station numbers to each 
station defined for the line, beginning with I for the 
first station specified. Note that a station number is 
unique for the line, not just for the station's group. 



Stati 
(0:1) 
(1:1) 



on 



type 

s 



Ignored, 

= The terminal's input block 

be the same as the line's 

1 s The terminal's input bl 

contained in bytes 2-3 of 
(2:6) » HP 2645 terminal 

1«40 s Reserved for HP use, 
41-63 - Reserved for user defined 
Number of components attached to this s 
Integer value of the terminal's fixed-1 
This number specifies a word length 
byte length if negative. 
Note: This parameter should only be p 
if bit (l:l) of the station descr 
one. 



size value shall 
BUFFSIZE value, 
ocksize value is 
this field. 



terminal types, 

tation, 

ength block size. 

if positive, and a 

resent if and only 
iptor is set to a 



Field four » 



Byte 
Byte 1-k 



Component field. Repeated for each component of the 

station, COPEN assigns logical component numbers for each 

component defined for the station, beginning with zero for 
the first component specified in the station. 

Length of component ID portion of the polling sequence. 

May be set to zero. 

Component's polling ID, This field is omitted if the 
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length is zero. 
Byte (k+l) Length ot the component ID portion of the selection 

sequence. May be set to zero. 
Byte (»c+2)-m Component's selection ID. This field is omitted if the 

length is zero. 



c 
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MISCAPRAY 

MISCARRAY is a word array with the following format: 

word number of words of parameter 

information following this 
word. 
1 parameter type 

2-n parameter 

Repeat the last two fields for each parameter 
type to be specified. 

Each parameter type will define the meaning and size of the parameter 
which follows it. Currently, the parameter associated with each 
parameter type consists of a single word quantity. The defined 
parameter types are 

- receive timeout In seconds.* 

(defaults20) 

*♦♦» (This value is Inapplicable to, and ignored by, HPDLC I.) 

1 - local timeout in seconds.* 

(defaults60) /^. 

♦♦*♦ (This value is inapplicable to, and ignored by, HPDLC llLJ 

2 - connect timeout in seconds.* 

(defaults900) 

3 - response timeout,* 

(defaults3) 

**** For the HPDLC I protocol this Is parameter Tl. 

Configured default values vary with the 

transmission speed, as specified below. 

SPEED(cps) HPDLC I RESPONSE TIMEOUT (see) 



5600 
5000 
4080 
1920 ♦» to be defined ** 

960 

480 

240 

4 • line bid timeout.* 
(defaults60) 

**♦♦ (This value is Inapplicable to, and ignored by, 
HPDLC I.) 
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5 - number of error recovery retries by driver. 

(Default=6) 

6 • s 0, Clear-to-send delay shall be the default (which is 

determined by the modem for the S5LC board). 
<>0, Clear-to-send delay value in tenths of seconds, 

ion the SCCP, clear-to-send delay defines the amount of time 
the driver will await the expected clear-to-send change 
before deciding that the modem is broken. The default value 
is 300 msecs; a non-zero value will override this default. 

7 - = Or No time will be allowed for the Data Set Ready signal 

to stabilize, 
s 1, Wait 100 milliseconds for the Data Set Ready signal 
to stabilize after it first goes true. 

B - s 0, Set the line's transmission mode to full-duplex, 

a I, Set the line's transmission mode to half-duplex. 

♦♦*♦ (This value is inapplicable to, and ignored by, 
HPDLC I.) 

9 - s 0, Disable MMSTAT trace facility. 

oOr Enable MMSTAT trace facility to trace the driver's state 
transitions. When using the SSLC or the HSI interfaces, 
MMSTAT is used to trace the interface driver's state 
transitions. When using the SC3 interface, MMSTAT is 

♦♦♦ yet to be defined ♦♦♦ 
This facility is described in the MPE Memory Manager 
documentation. 

♦♦♦♦ The following three parameters are used only for lines in 
multipoint control mode, and are otherwise ignored. 

10 - Poll loop delay. Parameter is the number of hundredths of 

seconds of delay between iterations through a wrap (circular) 
polling list. 

11 - Poll repeat. Parameter specifies the maximum number of 

iterations through the polling list. A value of zero implies 
an unlimited number of passes through the list. A value other 
than one makes the list a wrap (circular) list. Polling is 
terminated when either of the following conditions occurs: a) a 
station responds to a poll or b) the specified number of passes 
through the polling list has been made with no station 
responding. 

12 - Poll entry delay. Parameter is the delay in milliseconds 

between polling each entry in the polling list. If this 
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parameter is omitted then the default value will be taJcen from 

a. the configuration dialogue for pre-conf igured lines 

b. from the driver for all other cases. 



A value of zero will disable the timeout. 



o 
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CTRACEINFO is used to control the CS trace facility; its fields are as 
follows? 

(8s8) Number of trace entries. This value represents the number of CS 
trace entries which will be accumulated, for each I/O request, 
before wrap around occurs. If this field Is zero, a 
driver-dependent default will be used. 

(2s6) CS trace mask. 

This field is a masK which will indicate to the driver which types 
of information are to be traced. If this field is zero, a 
driver-dependent default will be used. 

For the drivers using the Bisync protocol, the format of the trace 
masK is as follows: 

bit 2 generate STN entries 

3 generate OPR and EDT entries * 

4 generate RCT entries ♦ 

5 generate RTX entries ♦ 

6 generate SCT, POL, SEL entries ♦ 

7 generate STX entries ♦ 






* default 
MOTE: CMP entries are automatically generated. 

For the HPDLC I SCCP driver, the format of the trace mask is as 
follows: 

♦*♦ to be defined ♦♦♦♦ 

(1:1) Trace entry fill type. 

This value specifies the action to be taken when the wrap-around 
condition occurs. setting the field to a one causes previous 
entries to be overlayed, whereas a value of zero will cause new 
entries to be discarded, 

(0:1) CS trace type. 

s trace on transmission errors only 

s 1 trace all CREAD, CWRITE, and CCONTROL requests. 



See Chapter 6 for a detailed discussion of the CS TRACE facility. 
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4.3 CLOSING LINES 






To terminate access to a line, a user's process must close the line 
through a CCLOSE intrinsic call. This intrinsic de-allocates the line 
and deletes the control blocics and CS supplied buffers (if any) through 
which communication with the remote devices attached to the line was 
accomplished. if the user does not issue CCLOSE calls for all lines 
opened by his process, the system will issue such calls when the 
process terminates. If this request is made to an SCCP device which 
reports a RAM system failure, a dump of the SCCP RAM is attempted via a 
CCONTROL 53 with a paramter of zero. 

The CCLOSE intrinsic declaration is as follows: 

PROCEDURE CCLOSE (LINENUMBER) ; 
VALUE LINENUMBER; 
INTEGER LINENUMBER; 
OPTION EXTERNAL; 

The CCLOSE intrinsic closes a CS line. If necessary, it will prepare 
the line for disconnection and then disconnect it. 

The condition codes for the CCLOSE intrinsic are as follows: 

CCE - The line was closed successfully. I y 

CCG - (This condition code is not returned.) 

CCL - The request was rejected because <linenumber> is invalid. 

The CCLOSE parameter is 

LINENUMBER An integer specifying the line number of the line to be 
closed. This is a required parameter. If the line was 
opened with the CIO specification and an I/O operation is 
pending, CCLOSE will abort the I/O operation and close the 
line in an orderly fashion. 
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) READING FROM REMOTE DEVICES 

To read from a remote device, a user process issues a CREAD Intrinsic 
call specifying the line to which the remote device is attached. 

The CPEAD intrinsic can perform two separate functions with respect to 
data transfer, the choice of which is line dependent. If the line to 
be accessed was opened with NCIO, CREAD will return control to the user 
process after completion of the data transfer from the remote station. 

If the line was opened with CIO, CREAD will cause the read operation to 
be initiated and then immediately return control to the calling 
process. A subsequent lOWAIT intrinsic call will wait for the read 
operation to be completed and data transferred into the user's stack. 
All CREAO intrinsic calls to a line opened with CIO must be followed at 
some point by an lOWAIT intrinsic call. Reads may be issued until the 
CREAD is rejected due to a lack of CS line buffers before it is 
necessary to issue an lOWAIT. It is guaranteed that reads will complete 
in the order in which they were requested. 

An lOWAIT intrinsic call must not be issued after a read request for a 
line opened with NCIO. 

-N^ If buffering is not used, the data read will be transferred directly 
; into the user's stack causing the stack to be frozen until completion 

^ of the read. The use of buffering does not require that the stack be 
frozen during the I/O transfer. Thus, more efficient memory management 
is obtained when buffering is used. This is particularly true for data 
communications I/O which is relatively slow and often depends on human 
interaction at the remote site. 

If this request is made to an SCCP device which reports a RAM system 
failure, a dump of the SCCP RAM is attempted via a CCONTROL 53 with a 
parameter of zero. 

within each data transfer function, the user can specify driver related 
operations to allow him complete control of the communications link 
between his program and the remote device. 

The CREAD intrinsic declaration is as follows: 

INTEGER PROCEDURE CREAD (LINENUMBER, INBUF, INCOUNT, STATION, 

READSTATION); 
VALUE LINENUMBER, INCOUNT, STATIONS- 
INTEGER LINENUMBER, INCOUNT; 
LOGICAL STATION, READSTATION; 
ARRAY INBUF; 
OPTION VARIABLE, EXTERNAL; 
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This intrinsic returns (as the value of CREAD) a non-zero i 
specifying the length of the received message for a line using NC 
no transmission errors incurred; else zero is returned. 



ntegef f 
CIO ir^ 



A positive value is always returned for the message length. If the 
INCOUNT parameter was negative, the procedure value represents bytes; 
If INCOUNT was positive, the procedure value represents words. 



The condition codes for the CPEAD intrinsic are as follows: 



a) AOPTIONS of COPEN Specified CtO: 



CCE • Read initiated. 

CCG • (This condition code is not returned.) 

CCL - Read not initiated, an error occurred. 

NOTE: A CCL will be returned if CS has no line buffer for the 
request (i.e., the line buffers were all allocated for 
previous requests; an lOWAiT should be issued to check for 
completion of these requests). 

b) AOPTIONS of COPEN specified NCIO: 

CCE - Read completed. 

CCG - End of Transmission sequence received. 

*♦♦ This condition code is never returned when using HpDLC I 
CCL - An error or an abnormal condition occurred. 



c 






The CREAD parameters are 



LINENUMBER 



an integer specifying the line number of the line, 
parameter is always required. 



This 



INBUF 



a word pointer specifying the DB-relative address of the 

user's input buffer. This parameter is not required and 

is Ignored when performing CIO with buffering or if 
INCOUNT has been set to zero or omitted. 



INCOUNT 



STATION 



an integer specifying the length of the data to be 
transferred. A positive value denotes words; a negative 
value denotes bytes. This value must not exceed the 
resultant BUFFSIZE as determined by COPEN. if this 
parameter is omitted, its value will be set to zero. 

a word identifying the logical station or logical ^rouo,,.^^ 

O 
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number of the remote tributary for a line in control 
mode. 

Station format 
(0!4) Set to zero. 
(4;4) Logical component number 
(8:8) Logical station number. A station number of zero 

is invalid. 

Group format 
(Oil) Set to one. 
(157) Set to zero, 

(8:8) Logical group number. A group of zero or 255 is 
invalid, 

A value of minus one for STATION specifies the currently 
accessed station. If STATION is absent or zero, the poll 
list will be used to solicit input. If the STATION 
parameter is specified and nonzero, the poll list is 
circumvented. Note: Logical group numbers may only be 
used for groups that support general poll. 

♦♦♦♦ This parameter is meaningful only when the local 
station is a control station and is Ignored for any other 
type of line mode. 



READSTATION If the local Station is a control station, READSTaTION is 
a word to which is returned the logical station and 
component numbers of the responding tributary station. 
If STATION was specified, then READSTATION s STATION. The 
READSTATION parameter format is identical to the station 
format of the STATION parameter. 

♦*** This parameter is meaningful only for lihes 
operating in control mode, and is otherwise zero. 



c 
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WRITING TO REMOTE DEVICES 



o 



To write to a remote device, a user process issues a CWRITE intrinsic 
call specifying the line to which the remote device is attached. 

Under the BSC line protocol, a conversational mode of communication can 
exist. This mode allows a transmission to be immediately followed by a 
receive on the same remote device. A user process can request such a 
conversational write in the call to CWRITE by specifying an input 
buffer. If the line has been opened with CIO and buffering, then only 
the INCOUNT parameter need be specified. 

If the line to be written to has been opened with the CIO specification, 
the user must eventually issue an lOWAIT call to suspend his process and 
await the completion of one of the pending requests. Writes may be 
issued until the CWRITE is rejected due to a laclc of line buffers before 
it is necessary to issue an lOWAIT. It is guaranteed that outstanding 
writes will complete in the order in which they were requested. 

An lOWAIT intrinsic call must not be issued after a write to a line 
using NCIO. 

If buffering is not used, the user's stacJc will remain frozen in memory-^ 
until completion of the write request. Thus, in general, bufferirf ^ 
should be used to allow more efficient memory management. The useV-^ 
should not attempt to access the write buffer specified in a CWRITE 
intrinsic call to a line using CIO if buffering is not used? data in the 
buffer may be destroyed before completion of the request by lOWAlT. 

If this request is made to an SCCP device which reports a RAM system 
failure, a dump of the SCCP RAM is attempted via a CCONTROL 53 with a 
parameter of zero. 

The CWRITE intrinsic declaration is as follows: 

INTEGER PROCEDURE CWRITE (LINENUMBER, OUTBUF, OUTCOUNT, INBUF, 

INCOUNT, STATION); 
VALUE LINENUMBER, OUTCOUNT, INCOUNT, STATION; 
INTEGER LINENUMBER, OUTCOUNT, INCOUNT; 
LOGICAL STATION; 
ARRAY OUTBUF, INBUF; 
OPTION VARIABLE, EXTERNAL; 

This intrinsic returns (as the value of CWRITE) a non-zero integer only 
for requests doing NCIO which did not incur transmission errors. This 
integer specifies the length of the sent message if the write request 
did not specify an input buffer; it specifies the length of the received 
message for write requests which do specify an input buffer. 



4-28 



A positive value Is always returned for the message length. If the 
INCOUNT parameter was negative, the procedure value represents bytes; if 
INCOUNT was positive, the procedure value represents words* 
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The condition codes for the CWRITE intrinsic are as follows: 

a) AOPTIONS of COPEN specified CIO: 

CCE Write initiated. 

CCG (This condition code is not returned.) 

cell Write not initiated, an error occurred. 

NOTE: This condition code will be returned if CS has no line 
buffers for the request (i.e., the line buffers are all 
allocated in previous requests; an lOWAIT should be issued 
to check for completion of these requests.) 

b) AOPTIONS Of COPEN specified NGIO: 

CCE Write completed. 

CCG End of Transmission sequence received, 

*♦»♦ This condition code is never returned when using HPDLC I. 
CCL An error or abnormal condition occurred. 

The CWRITE parameters are 



o 



LINENUMBER 



OUTBUF 



OUTCOUNT 



INBUF 



INCOUNT 



STATION 



an integer specifying the line number of the line. This 
parameter is always required. 

a word pointer specifying the DB-relative address of th?-=^ 
user's output buffer. This parameter is ignored if 
OUTCOUNT is omitted or set to zero. 

an integer specifying the length of the data to be output. 
A positive value denotes words; a negative value denotes 
bytes. This value must not exceed the resultant BUFFSIZE 
as determined by COPEN. If this parameter is omitted, its 
value will be set to zero. 

a word pointer specifying the DB-relative address of the 
user's input buffer. This parameter is not required and, 
hence ignored when performing CIO with buffering. It is 
ignored if INCOUNT is omitted or set to zero. 

♦♦♦♦ Conversational Bisync (i.e. MRJE HASP) requires both 
INBUF and INCOUNT. 

an integer specifying the length of the data to be input. 
A positive value denotes words; a negative value denotes 
bytes. This value must not exceed the resultant BUFFSIZE 
as determined by COPEN. If this parameter is omitted, its 
value will be set to zero. 



a word identifying the logical station or logical grou 
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number of the remote tributary for a line in control mode. 

Station format 
(0:4) Set to zero, 
(4:4) Logical component number 

(8:8) Logical station number, A station number of zero 
is invalid. 

Group format 
(Osl) set to one. 
(1:7) set to zero, 

(8:8) Logical group number, A group number of or 255 
is Invalid, 

A value of minus one for STATION specifies the currently 
accessed station. If STATION is absent or zero then all 
stations on the line are specified (line select). 
Notes: 1) Line select may only be used for lines that 

support line select. 
2) Logical group numbers may only be used for 

groups that support group select. 

»♦♦♦ This parameter is meaningful only when the local 
station is a supervised control station and is ignored for 
any other type of line mode. 



4-31 



4.6 COMPLETION OF CONCURRENT I/O REQUESTS 







If a CS line has been opened or CCONTROLed with the CIO specification, 
i.e., A0PTI0NS.(15:l)sl , all read and write requests must be followed 
oy an lOWAIT intrinsic call. This call initiates completion operations 
for the associated I/O request including data transfer into the user's 
stack if necessary. Multiple reads and writes to the same line may be 
issued before the lOWAIT call is made. This allows for maximum line 
utilization as well as I/O and processing overlap. 

If this request is made to an SCCP device which reports a RAM system 
failure, a dump of the SCCP RAM is attempted via a CCONTROL 53 with a 
parameter of zero. 

The lOWAlT intrinsic declaration is as follows: 

INTEGER PROCEDURE lOWAIT ( lONUMBER, INPUTBUFFER,REC0RDLENGTH,CS1NF0) ; 
VALUE lONUMBER? 

INTEGER lONUMBER, RECORDLENGTH; 
LOGICAL CSINFO; 
ARRAY INPUTBUFFER; 
OPTION VARIABLE, EXTERNAL; 

This intrinsic returns (as the value of lOWAlT) an integer representl 
the line number for which the completion occurred. If no completid" 
occurred, this number will be zero. 

The lOWAlT intrinsic can return the following condition codes: 

CCE - I/O completion occurred without errors (lOWAITOO). 

CCG - End of Transmission sequence received for CS device 
(lOWAITOO). 

♦*♦♦ This condition code is never returned when using HPDLC 
I, 

CCL • Normal I/O completion did not occur, because of an error or 
abnormal completion. 

1) no request(s) pending (lOWAITsO) 

2) parameter error (lOWAlTsO) 

3) I/O error or abnormal condition (lOWAlTOO) 

The lOWAIT parameters are 

lONUMBER An integer specifying a CS line number, an FS fil 
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INPUTBUFFER 



RECORDLENGTH 



CSINFO 



\u...-'' 



number, or zero, (NOTE: Within a single process, tile 
numbers and line numbers are unambiguous.) If zero or not 
specified, lOWAIT will wait for the first I/O completion, 
without distinguishing between file system and CS, If 
lONUMBER is positive, then lOWAIT will wait for the 
completion of that particular line or file number. 

A word pointer specifying the DB-relative address of the 
user's input buffer area to which the received 
message/record will be moved. This buffer area must be 
large enough to contain the input message/record. This 
parameter is required only if the COPEN specified 
buffering and the completed request was a read or a 
conversational write. 

A word to which is returned a positive integer 
representing the length of the record/message received or 
transmitted. If the original request specified a byte 
count, the integer represents bytes; if the request 
specified words, the integer represents words. This 
parameter is required only for reads and conversational 
writes? it is ignored for all other writes. 



A word to which is returned Information about 
completing request, with the following format: 
(0:1) Group flag 

= 1 Logical group number is specified 
= Logical station and component number is 
specified 



the 



(1:1) Type of completed request 
s Read 
= I Write or Write Conversational 

(4:4) Logical component number when local station is 
control station. 
Zero otherwise 



(8:8) Logical station number (if Group flagsO) 
Logical group number (if Group flagsl) 
local station is control station. 
Else zero. 



or 

when 
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4.7 OBTAINING LINE INFOPMATION 






,/ 



Once a user process opens a line, It can request information about that 
line from the CGETINFO Intrinsic. 

The CGETINFO intrinsic provides general Information about the line as 
actually opened. The information returned Includes 1) the parameters 
of the COPEN call as modified by jCLINE commands and CS (configured) 
default values, and 2) global information about the line such as its 
logical device number and line type. 

The CGETINFO intrinsic declaration is as follows: 

PROCEDURE CGETINFO (LINENUMBER, LDNUM, LINETYPE, COPTIONS, AOPTIONS, 

DOPTIONS, NUMBUFFERS, BUFFSIZE, IDLI5T, 
IDLISTLEN, SUPLIST, SUPLI5TLEN, POLLIST, 
POLLISTLEN, DWNLDFILE, YYYYY, PHONELIST, 
PHONELISTLEN, INSPEED, OUTSPEED/ MISCARRAY, 
MISCARRAYLEN, DPIVERNAME, CTRACEINFO); 

VALUE LINENUMBER, IDLISTLEN, SUPLISTLEN, POLLISTLEN, PHONELISTLEN , 

MISCARRAYLEN? 

INTEGER LINENUMBER, NUMBUFFERS, BUFFSIZE, IDLISTLEN, SUPLISTLEN, 

POLLISTLEN, YYYYY, PHONELISTLEN , MISCARRAYLEN; 

LOGICAL ARRAY POLLIST, MISCARRAY; 

LOGICAL LDNUM, LINETYPE, COPTIONS, AOPTIONS, DOPTIONS, 

CTRACEINFO; 

DOUBLE INSPEED, OUTSPEED; 

BYTE ARRAY IDLIST, SUPLIST, DWNLDFILE, PHONELIST, DRIVERNAME; 

OPTION VARIABLE, EXTERNAL; 

The condition codes for the CGETINFO intrinsic are as follows: 
CCE • The request was granted. 

CCG - The driver was unable to return the Information requested. 
CCL • The request was not granted because an error occurred. 

All CGETINFO parameters are optional except for LINENUMBEr. The 
parameters are defined as follows: 

LINENUMBER An integer specifying the line number of the line. This 
is a required parameter. 

LDNUM A word to which is returned the logical device number of 

the line. ^"^ 
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\ MNETYPK 



A word to whicn is returned three fields which define the 
type of line, 

(0:4) device subtype 
(4:6) device type 

(10:6) a number which provides a more succinct 
description of the line: 



1 


s 


SSLC 


- SW 


2 


= 


SSLC 


« NSW 


3 


s 


SCCP 


- SW 


4 


s 


SCCP 


- NSW 


5 


s 


H5I - NSW 



COPTIONS 



AOPTIONS 



DOPTIONS 






NUMBUFFERS 



BUFFSIZF 



IDLIST 



IDLISTLEN 



o 



A word to which is returned a bit string representing the 
communications options currently in effect. The format 
is the same as that of the COPTIONS parameter of COPEN. 

A word to which is returned a bit string representing the 
access options currently in effect. The format is the 
same as that of the AOPTIONS parameter of COPEN, 

A word to which is returned a bit string representing the 
driver options currently in effect. The format is the 
same as that of the DOPTIONS parameter of COPEN. Note 
that certain CCONTROL functions can change the value of 
DOPTIONS. 

A word to which is returned an integer indicating the 
number of buffers currently assigned to the line if 
positive, or the depth of the request queue if negative. 
This is the same format as that of the NUMBUFFERS 
parameter of COPEN. 

A word to which is returned an integer indicating the 
size of each buffer assigned to the line. BUFFSIZE will 
be positive or negative in correspondence with the 
BUFFSIZE parameter specified in COPEN. 

A byte array to which is returned an ID sequence list. 
The format is the same as that of the IDLIST parameter of 
COPEN. If IDLISTLEN is Zero or omitted, then the entire 
list is returned to IDLIST; otherwise, up to idLISTLEN 
bytes are returned to IDLIST. If no list was specified 
in COPEN or at configuration time, one byte will be 
returned (corresponding to the number of ID sequences) 
and its value will be zero. 

An integer specifying the length (in bytes) of the byte 
array IDLIST. If IDLISTLEN is zero or omitted, then it 
is assumed that IDLIST is sufficiently large to contain 
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SUPLIST 



SUPUISTLEN 



POLLIST 



POLLISTLEN 



DWNLDFILE 



the entire ID sequence list specified in COPEN or 
configuration tirne^ This parameter is ignored it IDLI 
is omitted. 



o 



A byte array to which is returned the list describing a 
supervised line. The format is the same as that of 
format #2 of the SUPLIST parameter of COPEN (exception - 
byte 2 is set to the total number of stations). If 
SUPHSTLEN is zero or omitted, then the entire list is 
returned to SUPLIST; otherwise, up to SUPLISTLEN bytes 
are returned to SUPLIST. If no list was specified by 
CLINE, COPEN, or at configuration time, then two bytes of 
zero are returned to SUPLIST. 

An integer specifying the length (in bytes) of the byte 
array SUPLIST. If SUPLISTLEN is zero or omitted, then it 
is assumed that SUPLIST is sufficiently large to contain 
the entire list describing the supervised line (as 
specified by the SUPLIST parameter of COPEN or by the 
configurator dialog). This parameter is ignored if 
SUPLIST is omitted. 

A word array to which is returned the polling list for 
the line. The format is the same as that of the POLLIST 
parameter of the CPOLLIST intrinsic. 

If POLLISTLEN is zero or omitted, then the entire list 
returned to POLLIST; otherwise, up to POLLISTLEN wor 
are returned to POLLIST. 

An integer specifying the length (in words) of the word 
array POLLIST. If POLLISTLEN is zero or omitted, then it 
is assumed that POLLIST is sufficiently large to contain 
the entire polling list for the line. This parameter is 
ignored if POLLIST is omitted. 

A byte array to which is returned the formal file 
designator of the down load file. The maximum length of 
the fi le name is 28 bytes long. When the designator is 
returned, unused bytes will be filled with blanics. If 
there is no down load file then the whole array will be 
blank filled. 



yyyYY (Reserved for future use.) 

PHONELIST A byte array to which is returned the list of phone 
numbers for a switched line. The format is the same as 
that of the PHONELIST parameter of COPEN, If 
PHONELISTLEN is zero or omitted, then the entire list is 
returned to PHONELIST; otherwise, up to phoneLISTLEN 
bytes are returned to PHONELIST. If no list w 
specified by COPEN or via configurator dialog, then o 
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byte of zero will be returned to PH0NELI5T. 



PHONELISTLEN 



INSPEED 



OUTSPEED 



MISCARRAY 



^p"^ 



MISCARRAXLEN 



DRIVERNAME 



CTRACEINFO 



An integer specifying the length (in bytes) of the byte 
array PHONELIST. If PHONELISTLEN is zero or omitted, 
then it is assumed that PHONELIST is sufficiently large 
to contain the entire pnone list specified by COPEN or at 
configuration time. This parameter is ignored if 
PHONELIST is omitted. 

A double word to which is returned an integer specifying 
the current input speed of the line in characters per 
second. 

A double word to which is returned an integer specifying 
the current output speed of the line in characters per 
second. 



A word array to which i 
information defined at the t 
MISCARRAY was not explicitly 
nevertheless exists in the 
format is the same as that of 
COPEN. If MISCARRAYLEN is ze 
information is returned to MI 
MISCARRAYLEN words are 
information is ordered 
parameter-type values. 



s returned miscellaneous 
ime the line was opened. If 
specified at COPEN time, it 
form of default values. The 

the MISCARRAY parameter of 
ro or omitted, then all such 
SCARRAY; otherwise, up to 

returned. The returned 
according to increasing 



An integer specifying the length (in words) of the array 
MISCARRAY. If MISCARRAYLEN is zero or omitted then it is 
assumed that MISCARRAY is sufficiently large to contain 
all pertinent Information. 

A byte array to which is returned the name of the driver 
for the line. The array must be at least 8 bytes long, 
and the name is left-justified with blank fill in the 
unused byte positions. 

A word to Which is returned CS trace facility 
information. The format is the same as that of the 
CTRACEINFO parameter of COPEN. A zero will be returned 
if the CS trace facility is not Invoked for this line. 
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4.8 OBTAINING MULTIPOINT GROUP INFORMATION 

This Intrinsic supplies detailed information about a remote group 
attached to a multi-point line. 

♦♦♦♦ This intrinsic is valid only for a multipoint line. 
The CGROUPINFO intrinsic declaration is: 

CGROUPINFO(LINENUMBER, LGNUM, GROUPDESC, FIRSTA, NUMSTA, POLLID, 
POLLIDLEN, SELID, SELIDLEN, GPOLLID, GPOLLIDLEN, 
GSELID, GSEUDLEN)? 

VALUE LINENUMBER, LGNUM; 

INTEGER LINENUMBER, LGNUM, FIRSTA, NUMSTA, POLLIDLEN, SELIDLEN, 
GPOLLIDLEN, GSELIDLEN; 

LOGICAL GROUPDESC? 

BYTE ARRAY POLLID, SELID, GPOLLID, GSELID; 

OPTION VARIABLE, EXTERNAL? 






The condition codes for the CGROUPINFO intrinsic are as follows: 
CCE - Request granted. 

CC<3 - (This condition code is not returned.) 
CCL - Request denied because an error occurred. 

All CGROUPINFO parameters are optional except for LINENUMbER, The 
parameters are defined as follows! 



LINENUMBER 
LGNUM 

GROUPDESC 

FIRSTA 



NUMSTA 



An integer specifying the line number of the line. 
This is a required parameter. 

An integer specifying the logical group number of the 
remote group. If this parameter is omitted, its value 
will be set to one. 

A word to which is returned in bits (8:8) the group's 
group descriptor. The format is the same as the group 
descriptor byte in the COPEN SUPLIST array. 

A word to which is returned the logical station number 
of the first station attached to the group™ The 
remaining stations attached to this group have 
successive logical station numbers. 

A word to which is returned the total number of 
stations attached to this group. 



J 
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I JPOLLID A byte array to which is returned the group's polling 

ID, The byte array must be 8 bytes long, when the 
actual ID is returned^ unused bytes in the array are 
null-filled to the right, 

POLLIDLEN A word to which is returned the length of the group's 

polling ID, 

SELID A byte array to which is returned the group's selection 

ID ID, The byte array must be 8 bytes long, when the 
actual ID is returned, unused bytes in the array are 
null-filled to the right. 

SELIOLEN A word to which is returned the length of the group's 

selection ID, 

GPOLLID A byte array to which is returned the group's general 

poll ID, The byte array must be 8 bytes long. When 
the actual ID is returned, unused bytes in the array 
are null-filled to the right, 

GPOLLIDLEN A word to which is returned the length of the group's 

general poll ID, 

(^^GSELID A byte array to which is returned the group's general 

selection ID, The byte array must be 8 bytes long. 

When the actual ID is returned, unused bytes in the 

array are null-filled to the right, 

GSELIDLEN A word to which is returned the length of the group's 

general selection ID, 
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4.9 OBTAINING MULTIPOINT STATION INFORMATION 



o 



This Intrinsic supplies detailed information about a remote station 
(terminal) attached to a multi-point line. 

♦♦*♦ This Intrinsic is valid only for a multipoint line. 

The CSTATIONINFO intrinsic declaration is: 

PPOCEDURE CSTATIONINFO(LINENUMBER, STANUM, COMPNUM, GROUPNUM, 

STATIONDESCr NUMCOMP, BLKSIZE, POLLID, POLLEN, SELID, 
SELEN); 
VALUE LINENUMBER, STANUM, COMPNUM; 
INTEGER LINENUMBER, STANUM, COMPNUM, GROUPNUM, NUMCOMP, BLKSIZE, 

POLLEN, SELEN? 
LOGICAL STATIONDESC; 
BYTE ARRAY POLLID, SELID; 
OPTION VARIABLE, EXTERNAL? 

The condition codes for the CSTATIONINFO intrinsic are as follows: 

CCE - Request granted. 

CCG - (This condition code is not returned.) i | 

CCL * Request denied because an error occurred. 

All CSTATIONINFO parameters are optional except for LINENUMbER. The 
parameters are defined as follows: 

LINENUMBER An integer specifying the line number of the line. 

This is a required parameter. 

STANUM An integer specifying the logical station number of the 

remote terminal. If this parameter is omitted, then 
its value is set to one. 

COMPNUM An integer specifying the logical component number of a 

component attached to the terminal. If this parameter 
is omitted, its value will be set to zero, 

GROUPNUM A word to which is returned the logical group number of 

the group to which the station is attached, 

STATIONDESC A word to which is returned in bits (8:8) the 

terminal's station descriptor. The format is the same 
as the station descriptor byte In format #2 of the 
COPEN SUPLIST array. 
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C>" 



MCOMP 



BLKSIZE 



POLLID 



POLLfc:N 



SELID 



SELEN 



A word to which is returned the number of components 
attached to the station. 

A word to which is returned the maximum block size 
which can be sent to the station, 

A byte array to which is returned the polling ID of the 
logical component specified by COMP. The byte array 
must be 8 bytes long. When the actual ID is returned, 
unused bytes in the array are null-filled to the right. 

A word to which is returned the length of the 
component's polling ID. 

A byte array to which is returned the selection ID of 
the logical component specified by COMP. The byte array 
must be 8 bytes long. When the actual ID is returned, 
unused bytes in the array are null-filled to the right. 

A word to which is returned the length of the 
component's selection ID. 



c 
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4.10 OBTAINING LINE ERROR AND STATUS INFORMATION 



o 



When a CS intrinsic returns a condition code indicating an error, the 
programmer can request additional information about the error by 
issuing a CCHECK intrinsic call. This intrinsic accepts zero as a 
legal line parameter value. When zero is specified, the returned error 
code reflects the status of the last COPEN or unsuccessful lOWAiT. 

The CCHECK intrinsic provides error information as well as last-event 
status information for the line. Under non-error conditions, a CCHECK 
intrinsic call will provide the user with additional line information 
complementary to that provided by CGETINFO. This information reflects 
the state of various lists as well as message and error counters for 
the last (completed) I/O operation on the line. 

The CCHECK intrinsic declaration is: 

PROCEDURE CCHECK (LINENUMBER, ERRORCODE, IDLISTINDEX, POLLISTINDEX, 

PHONELISTINDEX, MSGSENT, MSGRECV, RECOVERRORS, 
IRRECOVERRORS)? 

VALUE LINENUNBER; 

INTEGER LINENUMBER, ERRORCODE, IDLISTINDEX, POLLISTINDEX, 

PHONELISTINDEX, RECOVERRORS, IRRECOVERRORS; 

DOUBLE MSGSENT, MSGRECV; 

OPTION VARIABLE, EXTERNAL; 

The condition codes for the CCHECK intrinsic are as follows: 

CCE - Request granted. 

CCG - (This condition code is not returned.) 

CCL - Request denied because an error occurred. 

All CCHECK parameters are optional except for LINENUMBER. for those 
parameters returning an index, the index should be used as a subscript 
to the corresponding array returned by CGETINFO. The parameters are 
defined as follows; 

LINENUMBER An integer specifying the line number of the line. 

This parameter is required. If LINENUMBER has a value 
of zero, the returned error code reflects the status of 
the last COPEN or unsuccessful lOWAlT, whichever is the 
most recent. 
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ERRORCODE 



IDLISTINDEX 



POLLISTINDEX 



PHONELISTINDEX 



"X 



MSGSENT 



MSGRECV 



RECOVERRORS 



A word to which is returned a 16-bit code, specifying 
the type of error that occurred. If the previous 
operation was successful, all bits are set to zero. 

In the 16 bits returned to the word specified by the 
ERRORCODE parameter, the Xow-order eight bits contain 
the error-type code that shows what kind of error 
occurred. The high-order eight bits specify the last 
recoverable line-error that occurred on the last I/O 
access. Error codes are listed later in this section. 

A word to Which is returned an integer whose value 
denotes the (byte) subscript position of the most 
recently used entry in the list of ID sequences. A 
value of zero indicates that there is no "current" 
entry. 

A word to which is returned an integer whose value 
denotes the (word) subscript position of the most 
recently used entry in the polling list. A value of 
zero indicates that there is no "current" entry. 

A word to which is returned an integer whose value 
denotes the (byte) subscript position of the current 
entry in the list of phone numbers. A value of zero 
indicates that there is no "current" entry. 

A double word to which is returned an integer 
indicating the number of messages that have been sent 
successfully over the line since the line was last 
connected. Note that SSLC transmissions which end in 
ETB, as well as ETX, are counted as messages. 

A double word to which is returned an integer 
indicating the number of messages that have been 
received successfully over the line since the line was 
last connected. Note that SSLC transmissions which end 
in ETB, as well as ETX, are counted as messages, 

A word to which is returned an integer indicating the 
number of recoverable errors that have occurred on the 
line since the line was last connected. 



IRRECOVERRORS 



A word to which is returned an integer indicating the 
number of irrecoverable errors that have occurred on 
the line since the line was last connected. 



^S, 

^^y' 
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4.11 CCHECK Irrecoverable Error Codes (ERRORCODE (8:8)3 



o 



The CCHECK irrecoverable error codes codes have been divided 
subsets. 



into six 



Range Description 



request completed successfully 
1-40 an error was found by the COPEN intrinsic 
41 - 50 the request was not initiated because of 

an error found by the CS Intrinsics (including COPEN) 
51 • 100 the request was not initiated because of 
an error found by the CS Intrinsics 
(except COPEN) 
101 - 150 a hardware error occurred 
151 • 200 an error or exceptional condition which resulted 

in the line's being disconnected (driver dependent) 
201 - 250 an error or exceptional condition occurred which 

which did not result in the line's being disconnected 
(driver -dependent) 

The following tables describe the defined error codes, 

NOTE: The heading "BSC P-P" includes both conversational 
and non-conversational BSC. 



o 
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COPEN INTRINSIC - IRRECOVERABLE ERRORS 
NUM DESCRIPTION 






\ 



Request completely successfully 

1 none or too many groups 

2 none or too many stations 

3 none or too many components 

4 invalid poll/selection sequence length 

5 not enough stack space for COPEN to process 

6 invalid driver name 

7 driver not found 

8 driver not compatible with line's attributes 

9 driver not changeable 

10 undefined device 

11 device not available 

12 not cs device 

13 cs device in use 

14 invalid id sequence length 

15 invalid buffer size 

17 invalid phone number length 

18 illegal character in phone number 

19 not compatible with line type 
X 20 invalid information type in MISCARRAY 

21 invalid information value in MISCARRAY 

23 invalid entry in the poll list 

24 could not open trace file; issue FCHECK(O) to find 
specific File System error code 

25 invalid trace entry size 

26 invalid user capability 

27 invalid line designator 

28 no designator or device specified 

29 too many files/lines 

31 insufficient memory space 

32 driver failed to open line 

33 local mode was control station, but SUPLIST parameter 
was not specified 



BSC 


BSC 


HPDLC 


P-P 


MP 


I 


••" 


--• 


•-• 


X 


X 
X 
X 
X 
X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 




X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 
X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 
X 


X 
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ALL INTRINSICS - IRRECOVERABLE ERRORS 
NUM DESCRIPTION 



48 no Virtual memory available for trace and/or 
buffering 

49 db not pointing at stack 



BSC BSC HPDLC 
P-P MP I 



XXX 
XXX 



O 



NON-COPEN INTRINSICS - IRRECOVERABLE ERRORS 
NUM DESCRIPTION 



51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
63 
64 
65 
66 
67 
73 
76 
77 

78 
79 
115 
116 



invalid line number - no such line 

invalid parameter value 

I/O error on trace file 

not used 

buffer or count not specified 

invalid buffer count parameter 

no answer to dial attempt 

no phonelist for dial attempt 

bad dial msg, - system problem 

invalid array length parameter 

bad ccontrol code 

no I/O in progress for abort 

abort ignored 

logical group number is invalid 

logical station number is invalid 

logical component number is invalid 

parameter bounds violation 

buffer parameter required but not specified 

maximum number of I/O requests are already 

outstanding? must first issue lOWAIT 
no l/O-s pending for any file/line 
no I/O pending for specified file/line 
SCCP RAM system failure 
Mainframe driver time-out error 



BSC 


BSC 


HPDLC 


P-P 


MP 


I 


«■»■* 


"""• 


--- 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 
X 
X 

X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 



o 
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HARDWARE RELATED IRRECOVERABLE ERRORS 
NUM DESCRIPTION 



83 


SCCP 


85 


SCCP 


87 


SCCP 


88 


SCCP 


89 


SCCP 


90 


SCCP 


91 


SCCP 


92 


SCCP 


93 


SCCP 


94 


SCCP 


95 


SCCP 


96 


SCCP 


97 


SCCP 


98 


SCCP 


99 


SCCP 


SOI 


Non-r 


102 


Trans 


103 


Data 


104 


Carrl 


105 


Data 



control character 



system failure 

parity error 

received bad selt-test 

DMA self-test error 

microprocessor (MC2) failure 

ROM faiure 

RAM failure 

USART transmitter overrun 

USART parity error 

USART self-test receive error 

USYNRT self-test transmitter underrun 

USYNRT self-test receive error 

USYNRT self-test receive 

USYNRT self-test receive 

USART self-test received 

esponding device 

fer error 

set not ready 

er loss 

overrun 



overrun 
aborted 
no data 



BSC 


BSC 


HPDLC 


P-P 


MP 


I 


--• 


•> «■ • 


•>«»■■ 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 





DRIVER DEPENDENT IRRECOVERABLE ERRORS RESULTING IN DISCONNECTION 

BSC BSC HPDLC 
NUM DESCRIPTION P-P MP I 



151 Connect timeout 

153 Remote rejected the connection 

154 Power failure occurred 

155 Local timeout 

156 An internal error was detected by the driver 

157 Remote protocol error 

158 Remote sent shutdown sequence and 

159 Remote sent shutdown sequence and 
before the I/O request was Issued. 

160 An internal error was detected by MPE 



disconnected 
disconnected 
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OTHER DRIVER DEPENDENT IRRECOVERABLE ERRORS 

BSC BSC HPDLC 
NUM DESCRIPTION P-P MP I 



^^nngl^ 



201 Operation aborted XX X 

202 Invalid user request XXX 

203 Remote is not ready to accept line bid X 

204 Remote rejected the line bid X 

205 Remote primary station bid for the line while local X 
user was also bidding 

206 Remote has requested to send (an RVI sequence was X 
received) 

207 Retry count exhausted XXX 

208 Unexpected text was received X X 

209 Receive timeout XX 

210 Remote sent end-o£-transmlsslon X 

211 Remote sent end-ot-transmlsslon sequence and X 
disconnected before the I/O request was Issued. 

212 During the execution of a CWRITE conversational with X 
output buffer specified to also be the Input buffer; 

the remote requested a resend of the output buffer but 
Its contents had been modified while receiving from 
the remote. 

213 Remote sent an ACK sequence In response to local X 
CREAD acknowledgement. 

214 Remote sent a NAK sequence In response to local CREAD X 
acknowledgement. 

215 Remote sent an RVI sequence In response to local X 
CREAD acknowledgement. 

216 Remote requested a download sequence be Initiated X 

217 No line bid was received from the remote, local timed X 
out 

218 Remote sent a delay sequence instead of the expected X 
text/response 

219 The entries In the polllst were polled the required X 
number of times, and no station responded 

220 An EOT was received from the remote before the last X 
block of a multlblock transmission was sent 

221 After an RVI was sent to the remote, the remote X 
responded with text Instead of the (expected) EOT 

222 Pollentry down or Polllst down X 

223 Too much data was transmitted by the remote; X 

part of the data was lost. 



o 
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% CCHECK Recoverable Error Codes lERPORCODE (0:8)) 

The following table describes the defined recoverable 
error codes. 

RECOVERABLE ERRORS 

BSC BSC HPDLC 
NUM DESCRIPTION P-P MP I 



No recoverable error occurred XXX 

1 Invalid ID sequence received X 

2 Received unintelligible sequence XXX 

3 Block check characteror field check sequence error X XX 

4 Response timeout XXX 

5 Received Incorrect acknowledgement X X 

6 Remote attempted to bid for the line X 

7 Remote did not respond to local's line bid X 

8 Received unintelligible sequence after sending text X X 

9 Received enquiry character after sending text X X 
10 Remote requested a resend of local's last response X X 

U Remote requested resend of last text block XXX 

12 Received end-of-transmission character while in X 

control state 

!3 Received text overflow XXX 

!4 Data overrun occurred on SIO multiplexer XXX 

15 Transfer error occurred on the SIO multiplexor XXX 

16 Data overrun on the SCCP interface board X 

17 Data underrun on the SCCP interface board X 

18 Host sent invalid data to 3270 station X 
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4,13 DISPLAYING LINE INFORMATION 



o 



The CS user may request a display of all relevant Information about any 
CS line by invoking the PRINT'LINE'INFO intrinsic. 

The PRINT'LINE'INFO intrinsic declaration is as follows: 

PROCEDURE PRINT'LINE'INFO (LINENUMBER,OUTFILE) ; 
VALUE LINENUMBER,OUTFILE| 
INTEGER LINENUMBER^OUTFILE; 
OPTION EXTERNAL, VARIABLE; 

PRINT'LINE'JNFO is Simply a Utility intrinsic, having no special 

privileges, which formats and writes to OUTFILE the information 

returned by the CS intrinsics CGETINFO, CCHECK, and certain options of 

CCONTROL. Figure 4-1 is a sample output of PRINT'LINE'INFO. 

The parameter LINENUMBER is the CS line number returned by the COPEN 

intrinsic. If LINENUMBER=0 or is not specified then only the CCHECK 

information is displayed. If OUTFILE=0 or is not specified then 
SSTDLIST is used. 

The condition codes returned by PRINT'LINE'INFO are as follows: 

CCE - PRINT'LINE'INFO completed successfully f^ 

CCG - an end-of-file was detected while writing to OUTFILE -^^ 
CCL - an error was detected while writing to OUTFILE 
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-/i^t***^***^**^*iii*^$^*^^*^f.**'^t*^*4^t*^ ****** ******* 
♦ -L-I-N-E-«-I-N-F-0-R-M-A-T-I-0-N[«--D-I-S-P-L-A-y* 



* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 



* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 



LINE 
DEV. 



LOGICAL 



NUMBER: 6 

TYPE: 19 SUBTYPE: 

0123456789012345 

COPTIONS: 0010000010000010 

AOPTIONS: 0000000100001100 

DOPTIONSS 0000000100000000 



DEV, NUMBER: 54 
3 ver: a. 00. 03 



NUMBUFFERS: 1 
INSPEED; 2500 
MISCARRY: 



BUFFSIZE: 
OUTSPEED: 
RECEIVE TIMEOUT: 



LOCAL 

CONNECT 

RESPONSE 

NO. ERROR 

CLEAR-TO-SEND 

DATA-SET-READY 



TIMEOUT: 
TIMEOUT: 
TIMEOUT: 
RETRIES: 
DELAY: 
DELAY: 



(WORDS) 
SECS. 
SECS. 
SECS. 
SECS. 
SECS. 



1000 
2500 
30 
900 
900 
3 
7 
: 00.0 SECS 
DISABLED 
DUPLEX 
ENABLED 

MSECS.* 

♦ 

MSECS.* 



DRIVERNAME: 
CTRACEINFO: 



UNCONNECTED 



POLLIST: 

I STA = 
3 GRP= 
5 STA= 

PHONELIST: 

IDLIST: 

SUPLIST: 



TRANSMISSION MODE : 

MMSTAT TRACE FACILITY: 

POLL LOOP DELAY : 

POLL REPEAT ; 

POLL ENTRY DELAY : 

CSSBSCl LINESTATE: 

ENTRIES=25 MASKsl 11111 
TYPE OF TRACE = ALL, WRAP 

INDEX=2 
2 STAs 2 CMP= 
4 STAs 4 CMP=12 
6 GRPs 1 

INDEXsO 
INDEXsO 

DESCsOlllOOO 



DESCsOOUOOl 



ENTRIES=6 
1 CMP= 
2 
11 CMP= 2 
ENTRIESsO 
ENTRIES=0 
GR0UPS=1 
LINE SEL=A1 Al 
GRP 1 STATI0NS=1 

POLL ID =41 41 
SEL ID =61 61 
GEN POLL ID=22 22 
GEN SEL ID=F6 F6 
STA 1 COMPONENTS= 1 UP TYPE=0 
CMP P0LL=46 46 
SEL =46 46 
ERRORCODE: RECOVERABLE=0 IRRECOVERABLE=0 
MSGSENT: 22 MSGRECV: 9 

RECOVERROPS: 3 IRRECOVERRORS: 



*********:ff^t* ************************* ************ 






Figure 4-1. PRINT'LINE'INFO Sample Output 
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LEGEND: 1) COPTIONS, AOPTIONS, DOPTIONs; and Trace MASK are %^ 

in binary, 

2) PoXl and Selection ID sequences are in hexadecimal 

3) All other numbers are in decimal* 



o 
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^ DIRECTING LINE CONTROL OPERATIONS 

The user can perform various control functions to modify the operation 
Of a line by issuing a CCONTROL intrinsic call. These functions 
include list and list index modifications, 1/0 request cancellation, 
and line configuration changes. List modification provides a mechanism 
for list entry insertion and deletion. List index modification allows 
the user to alter the normal (i.e., sequential) scanning of CS list 
structures. 

The CCONTROL intrinsic provides a means for cancelling any outstanding 
I/O requests. An intrinsic call for this purpose may be issued at any 
time (after the line is opened). All other CCONTROL functions require 
that any outstanding CIO requests be quiesced via the lOWAlT intrinsic 
before the desired operation is performed. A CCONTROL error will result 
if there is any outstanding I/O when the CCONTROL is issued. 

The CCONTROL intrinsic declaration is as follows: 

PROCEDURE CCONTROL (LINENUMBER, CONTROLCODE, PARAMETER); 
VALUE LINENUMBER, CONTROLCODE; 
INTEGER LINENUMBER, CONTROLCODE; 
LOGICAL PARAMETER; 
OPTION EXTERNAL; 

The condition codes for the CCONTROL intrinsic are as follows: 
CCE - Request granted. 

CCG - (This condition code is not returned.) 

f 

CCL - Request denied because an error occurred. 

NOTE: In CIO mode with CONTROLCODE <>0, a CCL will be 
returned if any I/O requests are outstanding. 

The CCONTROL parameters are 

LINENUMBER An integer specifying the line number of the line, 

CONTROLCODE An integer defining the specific operation to be 
performed. 

PARAMETER A word whose interpretation is a function of the 
particular CONTROLCODE. 
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The foUowlng is the definition of the various control codes and the |J 
corresponding parameters: 



4.15 CONTBOLCODE Functions 

cancels an outstanding request (or requests) on a line. 

A request that has not been physically initiated is cancelled. A 
request that has been physically initiated is allowed to complete 
with one exceptions 

If a polling operation is in progress and no affirmative response 
is received from the polled component, then the request is 
cancelled without completing the polling list. 

PARAMETER specifies which request or requests to abort. ^/^^^" 

abort all outstanding I/O -n - abort the n th oldest read 

request (i being the oldest) ^m - abort the m'th oldest write 
request 

note: This CONTROLCODE request is meaningful only for lines opened 
with the CIO specification. 

1 Reset the line from text state to control state. 

An end-of-transmission sequence (EOT) is sent to the remote. 

NOTE: a. If the current state is control then an EOT 
will still be sent, 
b. If the current state is unconnected then this 
CCONTROL is ignored. 

2 Disconnect the line 

A disconnect sequence is sent to the remote and the connection is 
brolcen. The type of disconnect sequence (EOT or DLE LOT) is a 
function of PORTIONS. (4:2) or a previous CCONTROL with controlcode 
of 258. 

NOTE: If the line is already disconencted, then this CCONTROL is 
ignored. 



o 






4-54 



( 



32 changes the Index into the phone list to the value PARAMETER, 
which is an integer denoting a byte subscript position into the 
phone list array. 

A condition code of CCL will be returned if PHONELISTCPARAMETER) 
does not point to a valid phone list entry. 

33 inserts an entry into the poll list for a multi-point line. 

PARAMETER is the entry to be inserted at the bottom of the poll 
list. PARAMETER has the same format as a pollist entry in in the 
CPOLLIST Intrinsic. 

A condition code ot CCL will be returned if the entry does not 
have the correct format. 

♦♦»♦ This control code is only valid for multi-point lines. 

34 deletes an entry from the poll list for a multi-point line. It the 
entry appears more than once in the POLLIST, then all instances 
are deleted. 

PARAMETER is the entry to be deleted, and has the same format as 
a pollist entry in the CPOLLIST intrinsic. 

A condition code of CCL will be returned if the entry to be 
deleted does not exist in the list. ♦♦♦♦This control code is only 
valid for multi-point lines. 

35 Change POLLIST index. 

changes the index into the poll list to the value PARAMETER which 
is an integer denoting a word subscript position into the poll 
list array. 

♦♦♦♦ This control code is only valid for multi-point lines. 

36 change dialing convention. 
PARAMETER 

s dial on write connects; answer on read connects 

s I answer on write connect; dial on read connect 

s 2 dial on write connect; dial on read connect 

s 3 answer on write connect; answer on read connect 

A condition code of CCL is returned if PARAMETER is negative or 
greater than 3. 
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37 change the value of the receive time out. fj 

If PARAMETER is a positive, nonzero number then it will be the new 
value of the receive timeout (seconds). A value of zero will 
cause the timeout to be disabled. Setting parameter to a minus 
one will set the timeout to the default value of 20 seconds. Any 
other values of parameter are invalid. 

*♦*♦ This control code is not valid for lines using HPDLC I. 

38 change the value of the local timeout. 

If PARAMETER is a positive, nonzero number then it will be the new 
value of the local timeout (seconds). A value of zero will cause 
the timeout to be disabled. Setting parameter to a minus one will 
set the timeout to the default value of 60 seconds. Any other 
values of parameter are invalid. 

*»♦♦ This control code is not valid for lines using HPDLC I. 

39 change the value of the connect timeout. 

If PARAMETER is a positive, nonzero number then it will be the new 
value of the connect timeout (seconds). A value of zero will 
cause the timeout to be disabled. Setting parameter to a minus 
one will set the timeout to the default value of 900 seconds. Any 
other values of parameter are invalid. 

40 Change the number of error recovery retry attempts to be made by 
the driver. 

The COPEN default value (see MISCARRAY parameter of COPEN) is 
driver-dependent. 

PARAMETER is the new number of retry attempts. 
PARAMETER must be a positive integer. 

41 change local station mode for a contention line. 

PARAMETER a I Set local Station to a primary contention 

station 

ss 2 set local station to a secondary contention 

Station 

« 3 set local station to a control station 

s 4 set local station to a 3270 secondary station 

» 5 set local station to DTE 

9 6 set local station to DCE 

A condition code of CCL will be returned if 
PARAMETER is negative or greater than 
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6. 

42 read line state 

PARAMETER is a word to which is returned the current state of 
the line. 

PARAMETER (0.8) s reserved 

(8:8) s = unconnected 
= 1 = control 
s 2 = text 

♦♦♦♦ This control code is not valid tor lines using HPDLC I. 

43 Disable Tracing 

Parameter is ignored. 

The core-resident trace area in deleted and if this is the only 
line accessing the trace file, the trace file is closed. If the 
line is not tracing thru this CCONTROL is ignored. 

44 Enable Tracing 

parameter(O) s same meaning as the CTRACEINFO 

parameter of COPEN 
PARAMETER(l) s first word of the array describing 
the trace file. The type of array 
is defined by PARAMETERC 1 ) . (0:8) : 
alpha s the array contains a formal file 

designator 
numeric = the array contains an ASCII number 
specifying the trace file's logical 
device number 
special = the array contains a device class 

name starting in PARAMETER(l). (8:8) 

If the line already has a tracing it is first disabled (see 

CCONTROL with OPCODE =43). A main memory trace area is created 

for this line and, if the trace file is not currently being 
accessed, the trace file is opened. 

45 Return current remote ID sequence 

Parameter = word address of a nine word array to which is 
returned: 

word - length of current remote ID (set to 

if there is no current remote ID) current 

words 1-8 - remote ID sequence 
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46 Change concurrent I/O specification gj 

Parameter (15j1) = • NCIO 

1 a CIO 
NOTE! CIO without buffering is allowed only when the user 
is operating in privileged mode, 

47 Change the value of the response time out, 

parameter is the value of the response timeout (seconds). 
Parameter must be a positive value. A value of zero will disable 
the timeout. 

For HPDLC I protocol, this is parameter Tl, the maximum amount of 
time the local will wait for a response to a transmitted 
Information frame. 

48 Change the value of the line bid time out. 

Parameter is the value of the line bid timeout (seconds). 
Parameter must be a positive value. A value of zero will disable 
the timeout. 



49 Enable/Disable MMSTAT Driver Trace 

PARAMETER » Disable trace 
I Enable trace 

50 Current ID in Configured ID List 

Determines if the current ID is in the configured ID list. Values 
returned in PARAMETER are: 

«l Current ID is not in configured list 

Zero length current ID not in configured list 

1 Zero length current ID is in configured list 

2 Non-zero length current ID is in configure list 

51 Set all components in pooll list up. 

Resets any components in the poll list that were marked down due 
to lacJc of response to up, 

♦ j^*» This control code is only valid for multi-point lines. 

52 Return last transmission log 

Returns the transmission log of the last CS I/O event returned to 

user® 
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53 Dump sec? RAM 

The SCCP RAM contents, mainframe driver Information, and CS I/O 
request information is stored in a file. An attempt is made to 
open the file to receive the dump information as new; if 
successful, the dump proceeds. If an old file with that name is 
found, the dump is not initiated. Thus, if there are successive 
attempts to dump to the same file name, only the first attempt 
which opens the file new will actually dump the contents of the 
SCCP. 

PARAMETER is the first word of the array containing the desired 
dump file name. If zero, the name "CDUMP" with the logical device 
number appended will be used. 

A message is written is written to the operator console when an 
SCCP RAM dump is initiated and successfully completed. These 
messages are described in section 9.4. 

256 Changes the automatic generation of WACK and/or TTD sequences by 
the BSC drivers (both SSLC and HSI). 

PARAMETER (15:1) s I, disable automatic generation of WACK 

sequences, 

s 0, enable automatic generation of WACK 

sequences, (default: enabled). 

(14:1) s 1, disable automatic generation of TTD 
sequences. 

= 0, enable automatic generation of TTD 

sequences, (default: enabled). 

257 change the USASCII blocJc cnecJc character algorithm for the SSLC 
(BSC) driver. This contrulcode is ignored by the HSI (BSC) 
driver. 

PARAMETER s 0, VRC/LRC (non-transparent ) . 
CPC-16 (transparent) 
s 1, VRC/CRC-16 (non-transparent) 
CRC-16 (transparent). 

The default mode for the SSLC (BSC) driver is equivalent to 
PARAMETERsO. 

258 Change the disconnect sequence for the BSC drivers (both SSLC 
and HSI). 

PARAMETER = 0, send EOT for non-switched and OLE EOT for 
switched. 
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s! 1, always send DLE EOT. 
a 2, always send EOT. 

The detault mode for the BSC drivers Is equivalent to PARAmETERsO. 

259 inform the SSLC BSC driver whether or not to expect intermediate 
text block characters (itb's) to be received from the remote 
station. This CONTROLCODE is ignored by the HSI BSC driver. 

PARAMETER « 0, do not expect itb*s from the remote station. 

NOTE: The driver will accept itb's from the remote 
station in this mode and will format them as 
described in paragraph 4.8. However, it will be 
necessary for the remote to resend the first text 
blocK which contains ITBs. 

= i, expect to receive itb's from the remote station. 

NOTE! The driver will treat received text which 
contains no itb's as a degenerate case of itb 
reception. That is, MFW (1:1) will be set and the 
received text will be prefixed by a length (in 
bytes) and suffixed by a delimiter of all ones (see 
paragraph 4.8). 

This CCONTROL function in no way affects transmitted text. The 
default mode for the SSLC driver is equivalent to PARAMETERaO. 
Receipt of a text block containing itb's will cause the driver to 
automatically enter the mode equivalent to PARAMETERsl . 

260 Modify the action of the next CREAD 



O 



o 



Parameter = 
I 



2 s 



the CREAD will be executed in the 
normal manner. 

The next CREAD will send an RVI 
acknowledgement (instead of an ACKO 
or ACKl) then read the next text block 
The next CREAD will send a negative 
acknowledgement then read the last 
text block sent by the remote. 



All other Parameter values are invalid 



NOTE: 



This CCONTROL only applies to the next CREAD. 
subsequent CREAD's are performed in the 
normal manner. 

If at the time the next CREAD is initiated the 
line state is not text then the CREAD will not 
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be nnodlfied, 

261 Change the Message Format Word (MFW) convention tor SSLC Driver, 
parameter = MFW will not be placed into received text nor 

expected in sent text. The implicit MPW to be 
used to format sent text will be 000000. 

1 s MFW will not be placed into received text nor 

expected in sent text. The implicit MFW to be 
used to format sent text will be 100000. 

2 s MFW will be placed into word of the user's input 

buffer. It will be expected to be in word of 
the user's output buffer. 

262 Change Download Mode 

PARAMETER s = disable download mode 
I s enable download mode. 

A CREAD in unconnected or control state will 
interpret a NAK (instead of an ENQ) as a 
request for download, 

263 Read Download Byte 

The received download byte is returned to PARAMETER. (8;8) . 
PARAMETER(0:8) is Cleared. 

Note: This CCONTROL applies only to the SSLC Driver, the Hsi 
Driver will return a binary zero. 

264 Change Control state listen mode 

PARAMETER = = While in control state and between user requests 

the driver will listen for control sequences from 
the remote. Receipt of a line bid from the remote 
will cause the line to be placed into text state. 
1 s While in control state and between user requests 
the driver will ignore any control sequences 
issued from the remote. 

265 Reserved for 3270 use. 

266 Reserved for 3270 use. 

Some CCONTROL controlcodes are serviced completely by the driver, some 
by the intrinsic without involving the driver, and some by both the 
intrinsic and the driver. For these reasons, controlcodes are assigned 
using the following convention: 
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0-255 Controlcodes whose execution involves both the intrinsic ^J 
and the driver, 

256-16383 controlcodes executed by the driver. 
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yS Modifying Polling Lists 

A user process can create or update a poll list, after the line to 
which the poll list refers has been opened, by issuing a CPOLUST 
intrinsic call, in addition, this intrinsic allows other poll-related 
information to be changed by the user. In contrast to the CCONTROL 
intrinsic, which will add or delete a single station to or from a poll 
list, this intrinsic provides a facility for respeclf Ication of an 
entire list. 

♦♦♦♦ This intrinsic is only valid for multi-point lines 
The CPOLLIST intrinsic declaration is as follows: 

PROCEDURE CPOLLIST (LINENUMBER, POLLIST, POLLDELAY, 
POLLREPEAT, ENTRYDELAY); 

VALUE LINENUMBER, POLLDELAY, POLLREPEAT, ENTRYDELAY; 
INTEGER LINENUMBER, POLLDELAY, POLLREPEAT, ENTRYDELAY; 
LOGICAL ARRAY POLLIST; 
OPTION VARIABLE, EXTERNAL; 

All parameters to CPOLLIST are optional except LINENUMBER. If a 
parameter is not specified, its existing value will remain in effect; 
each parameter will have a default assigned at either configuration or 
COPEN time. 

The CPOLLIST intrinsic can return the following condition codes: 

CCE Reguest granted. 

CCG (This condition code is not returned.) 

CCL Reguest denied, because an error occurred. 

NOTE: In CIO mode, a CCL will be returned if any requests are 
pending on the line (i.e., no lOWAIT has been issued for the 
outstanding I/O). 

The parameters are defined as follows: 

LINENUMBER Ah integer specifying the line number of the line. This 
parameter is reguired. 

POLLIST A word array defining the groups, stations, and 
components to be polled and the order of polling: 
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word number of entries in the list 

I first entry of the list 

Station format 

(054) Set to zero. 

(4:4) Logical component number 

(8;8) Logical station number. 



^%MlP^ 



Group format 
(0:1) Set to one. 
(1:7) set to zero. 
(8:8) Logical group 
and 255 are 



number. 
invalid. 



Group numbers of 



2 second entry of the list 



POLLDELAY 



POLLREPEAT 



n nth entry of the list 

notes: 1) A poll list need not specify the total set of 
stations physically present on the line. Those 
that are not specified are never accessed. If 
POLLIST specifies one or more stations that are 
DOWN, these stations remain in the list but are 
not accessed. 

2) The poll list index Is reset to zero when 
POLLIST is present. (See POLLISTINDEX parameter 
of CCHECK). 

3) Group format is permitted only for terminal 
groups that have the general poll facility. 

Number of hundredths of seconds of delay between 
iterations through a wrap (circular) polling list. 

specifies the maximum number of iterations through the 
polling list. A value of zero implies an unlimited 
number of passes through the list. A value other than one 
makes the list a wrap (circular) list. Polling is 
terminated when either of the following conditions 
occurs: a) a station responds to a poll or b) the 
specified number of passes through the polling list has 
been made with no station responding. 



ENTRYDELAY 



Specifies the delay in milliseconds between polling 
entry in the POLLIST. 



each 



O 
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EXAMPLE I SECTION V I 
I I 



5.1 REMOTE FILE TRANSFER PROGRAM (CODED IN SPL/3000) 

This example shows a remote file transfer application program (named 
RFT) that transmits an existing MPE disc file from one HP 3000 Computer 
system to another. It is assumed that RFT is being executed 
simultaneously at both ends of the line and that the overall operation 
has been coordinated by a voice telephone conversation. 

The calling sequence (entered through the user's terminal) for the 
sending station is as followss 

:CLINE T;DEVsSSLCl 

:RUN RFT 

ENTER FILE NAME - 

Carriage return 
The calling sequence (entered through the user's terminal) for the 
receiving station is as follows: 

:CLINE R;DEV=SSLC2 

:RUN RFTl 

ENTER FILE NAME - 

Filename 

At the receiving station, RFT opens (as a new ASCII file) a file with 
the specified name and then transmits the filename to the sending 
station. At the sending station, RFT opens the specified file, 
transmits its record size, and then transmits the file, record by 
record, until an end-of-file is detected. When this occurs the sending 
station transmits an EOT control character to the receiving station and 
the operation is finished. 
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USLINIT,NOWARN, CODE, MAP 
MAINsRFT 



THIS PROGRAM, 
COMPUTERS, 



RFT, TRANSFERS DISC FILES BETWEEN TWO 



SCONTROL 

SCONTROL 

<< 

<< 

« 
<< 
<< 
<< 
« 
<< 
« 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
« 
<< 
<< 
<< 
<< 
<< 

S< 
<< 

BEGIN 

INTEGER READCNT,LINENUM,FILENUM, ANYTHING, RECSIZE,REC0RDCNT: SO; 

byte array remoteabortedcos i i) ss^remote aborted"; 
getfilename(o:16):s»enter file name -••; 
rectransferred(0:26):s"records transferred s 

CDESIGl(0Sl7):s:'*CSLINET CSCLASST "? 
CDESIG2(0S17)J = ''CSLINER CSCLASSR " ? 
DESIGC0:29):s" 
BUFFERC0J255):s0,0; 
PHONELIST(0:39)5sl,8,''257-1562"; 



THE TRANSMITTER'S DIALOGUE IS AS FOLLOWS: 

♦ SCLINE T;DEVsXXXXX ♦ 

♦ :RUN RFT ♦ 

♦ ENTER FILE NAME - ♦ 

* (DEPRESS THE CARRIAGE RETURN KEY) ♦ 
4t*ilf^*t^t***t*****'^***4^^**t4*i^*i^*t****$ **************** 

THE RECEIVER'S DIALOGUE IS AS FOLLOWS? 

il^:l^:^^^:^:$:^:^'$1^}l^iif^:^^^:^^4t********************************** 

* SCLINE R;DEVsXXXXXX ♦ 

♦ ;RUN RFT » 

* ENTER FILE NAME - * 

* FILENAME ♦ 

t************************ ******************** ********* 



THE RECORDS OF THE FILE, FILENAME, 
COMPUTER WILL BE SENT, A RECORD AT 
RECEIVER'S COMPUTER AND IS WRITTEN 
SAME NAME THERE. 



RESIDING IN THE SENDER'S 

A TIME, TO THE 

TO THE FILE WITH THE 



BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 



ARRAY 
ARRAY 
ARRAY 
ARRAY 
ARRAY 
ARRAY 
ARRAY 



N t 
f 



N • 



» 
» 
» 
» 
>> 
>> 
>> 
>> 
» 
>> 
>> 
>> 
» 
>> 
>> 
>> 
>> 
» 
>> 
» 
>> 
>> 
>> 
>> 
>> 
>> 
» 



o 



o 



EQUATE 

FSFOPTIONSl 
FSF0PTI0NS2 
FSAOPTIONSl 
FSA0PTI0NS2 



000003, 
000004, 
000000, 
OOOOOl; 



<< OLD >> 

<< NEW, ASCII >> 
« READ ACCESS » 
<< WRITE ACCESS >> 



EQUATE 

SENDEOT 3 l; 
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: ^TRINSIC READ,PRINT,ASCH,FOPEN,FCLOSE,FREAD,FWPITE, 

FGETINFO, TERMINATE, COPEN,CREAD, CWRITE,CCONTROL; 

PROCEDURE PRINT 'FILE' INFO (FILENUM); 

VALUE FILENUM; INTEGER FILENUM? OPTION EXTERNAL; 

PROCEDURE PRI NT 'LINE' INFO (LINENUM,OUTFILE); 
VALUE LINENUM,OUTFILE; INTEGER HNENUM,OUTFILE; 
OPTION VARIABLE, EXTERNAL; 



SUBROUTINE ENDOFJOB; 
BEGIN 
IF FILENUM <> THEN 

BEGIN 

FCLOSE (FILENUM, If 0); 

IF <> THEN PRINT'FILE'INFO(FILENUM); 

end; 

ASCII (RECORDCNT,10,RECTRANSFERRED( 22)); 

PRINT(RECTRANSFERRED,-27,0); 

TERMINATE; 

END; 

aROUTINE csproblem; 

BEGIN 

IF > THEN 

PRI NT ( REMOTEABORTED , - 1 4 , ) ; 
ELSE 

PRINT'LINE'INFO(LINENUM); 

ENDOFJOB; 
end; 

SUBROUTINE FSPROBLEM; 
BEGIN 

PRINT 'FILE 'INFO (FILENUM); 
ENDOFJOB; 
END; 

PRINT (GETFILENAME, -17,0); 
READCNT:s-READ(DESIG,-30); 
IF > THEN ENDOFJOB; 
IF READCNT = THEN 

BEGIN «SEND EXISTING FILE» 

LINENUM;=C0PEN(CDESIG1,CDESIG1(8)); 

IF <> THEN CSPROBLEM; 

READCNT:sCREAD(LINENUM,DESIG,-28); «GET FILE NAME FROM RECEIVER>> 

IF <> THEN CSPROBLEM; 
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FILENUM:sFOPEN(DESIG,FSFOPTI0NSl,rSA0PTI0NSl); C\ 

IF <> THEN FSPROBLEM? ^-^ 

FGETINFO(FILENUM, , , ,REGSIZE); 

RECSIZE:sIF RECSIZE > THEN -2*RECSIZE ELSE RECSIZE; 

CWRITE(LINENUM,RECSIZE,1)? «SEND FILE'S RECORD SIZE» 

IF <> THEN CSPROBLEM; 

DO 

BEGIN «TRANSFER CONTENTS OF THE FILE TO THE REMOTE» 
FREADCFILENUM, BUFFER, RECSIZE); 
IF < THEN FSPROBLEM; 
IF » THEN 
BEGIN 

RECORDCNTJsRECORDCNTfl; 
CWRITECLINENUM, BUFFER, RECSIZE); 
IF <> THEN CSPROBLEM; 
END; 
END UNTIL >; <<SENSED END-OF-FILE» , 

CCONTROL(LINENUM,SENDEOT, ANYTHING); 
IF < THEN CSPROBLEM; 
END 
ELSE 

BEGIN «RECEIVE NEW FILE» 

LINENUMssCOPEN(CDESIG2,CDESIG2 (8) ,,,,,,,,,, ,PHONELIST); 

IF <> THEN CSPROBLEM; 

«SEND FILE NAME AND GET RECORD SIZE OF THE FILE» ^^^ 

CWRITE(LINENUM,DESIG,READCNT-1, RECSIZE,!); | Jt) 

IF <> THEN CSPROBLEM; \J^ 

FILENUM:=FOPEN(DESIG,FSFOPTIONS2,FSAOPTIONS2, RECSIZE); 

IF <> THEN FSPROBLEM; 

DO 

BEGIN <<RECEIVE CONTENTS OF THE FILE» 
READCNTzsCREADCLINENUM, BUFFER, RECSIZE); 
IF < THEN CSPROBLEM; 
IF s THEN 
BEGIN 

RECORDCNTssRECORDCNTfl; 
FWRITE(FILENUM,BUFFER,-READCNT,0); 
IF <> THEN FSPROBLEM; 
END; 
END UNTIL >; <<EOT RECEIVED>> 
END; 
ENDOFJOB; 
END, 
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5,2 MULTIPOINT TRANSACTION PROCESSING PROGRAM (CODED IN SPL/3000) 

This example shows a transaction processing program that accepts data 
from HP 2645 terminals on one multipoint line. Normally the line's 
terminal configuration would already have been specified via SYSDUMP or 
INITIAL, However in this example both the CLINE SUPLIST and the COPEN 
SUPLIST array have been specified to illustrate their use. In this 
example the multipoint line type of 64 was arbitrarily chosen to 
indicate a line composed entirely of HP 2645 terminals. 



CLINE CSLINE 
SUPLISTs64,LSEL=:0(125, 125, 125,125), 

GRP sID5A''AA",A''aa",GEN=0(42,42),0(42,42), 
STA=0,512,A"AA'',A''aa'', 



GRP 



EQUATE 
HP2645 
OUTLENGTH 
INLENGTH 



STAsO,512,A"BB'',"bb'', 



=IDsA"BB","bb", 
STA=0,512,A''AA" 



A"aa" 



STAsO,512,A"BB%A-bb 
STAsO,512,A''CC'',A"cc 



n « 



= 0, 
= 100, 
= 100; 



BEGIN 
BYTE ARRAY 

64, 

1, 

0,2, 

4, 125, 






RAY 



SUPLIST(0:63):s 



125, 



125, 125, 

7,2, 

2,''AA",2,"aa'', 

2, 42, 42,2, 125, 125, 
HP2645,512,1,2,''AA'' 
HP2645,512,1,2,"BB'» 

7,3 

2,"BB-,2,"bb", 

2, 42, 42,2, 125, 125, 
HP2645,512,1,2,"AA'' 
HP2645,512,l,2,''BB'' 
HP2645,512,l,2,''CC'' 



STATIONS>> 



<<HP 2645 STATIONS>> 

<<LINE SELECT FACIHTY» 

<<TWO GROUPS>> 

<<HNE SELECTION SEQUENCE>> 

<<LOGICAL GROUP 1, NUMBER OF 

<<GROUP I.D.>> 

<<SUFFIXES FOR GENERAL POLL/SELECT>> 
,2,"aa'',<<L0GICAL STATION 1» 
,2,"bb",<<L0GICAL STATION 2>> 

<<LOGICAL GROUP 2, NUMBER OF STATION; 

<<GROUP I.D.>> 

«SUFFIXES FOR GENERAL POLL/SELECT>> 
,2,''aa'',<<L0GICAL STATION 3>> 
,2,"bb",<<L0GICAL STATION 4>> 
,2,"CC''?<<L0GICAL STATION 5>> 
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INBUF(0:99),OUTBUF(0:99); f\ 

BYTE ARRAY ^*-^ 

LINEDESIG(0:6): = ''CStINE ••; 
BYTE ARRAY 

PARTIALSUPLIST(05 3); 
INTEGER 

LINENUM/INLENGTH/OUTLENGTH; 
LOGICAL 

STATION, FATALERROR? 
DEFINE 

NUMSTATIONS = INTEGER(PARTIALSUPLIST(2) # ? 

PROCEDURE INITIALIZE(NUMSTATIONS); 
VALUE NUMSTATIONS; 
INTEGER NUMSTATIONS; 
OPTION EXTERNAL; 

LOGICAL PROCEDURE ANALYZECSERROR(HNENUM) ; 
VALUE LINENUM; 
INTEGER LINENUM; 
OPTION EXTERNAL; 

INTEGER PROCEDURE PROCESSTRANSACTION( INBUF, INLENGTH, 

OUTBUF, STATION); 
VALUE INLENGTH, STATION; 

ARRAY INBUF,OUTBUF; f ]) 

INTEGER INLENGTH; vJ^ 

LOGICAL STATION; 
OPTION EXTERNAL; 

INTRINSIC 

COPEN, CREAD,CWRITE, QUIT, CGETINFO, PRINT 'LINE 'INFO; 

LINENUM :sCOPEN(LINEDESIG, ,,,,,, ,SUPLIST) ; 
IF <> THEN 

BEGIN 

PRINT 'LINE 'INFO; 

QUITCO); 

END; 

CGETINFO(LINENUM, , , , , , , , , ,PARTIALSUPLIST,4) ; 
INITIALIZE(NUMSTATIONS); 

DO 

BEGIN «READ AND PROCESS ONE TRANSACTION» 
INLENGTH :xGR£AD (LINENUM, INBUF,INBUFLEN,, STATION); 
IF s THEN 

BEGIN 

OUTLEN:=PROCESSTANSACTION(INBUF, I NLENGTH,OUTBUF, STATION); 

IF OUTLEN <> THEN ^^ 

o 
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c 



BEGIN 

CWRITE(LINENUM,OUTBUF,OUTLEN,,,-n; 

IF <> THEN rATALERROH:sANALYZECSERROR(LINENUM); 

end; 

END; 
ELSE 

FATALERR0R:3ANALYZECSERR0R(LINENUM); 

END UNTIL FATALERROR; 
END; 
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1 1 

THE CS/3000 TRACE FACILITY 1 Section VI 1 

1 1 



o 



Each CS/3000 intrinsic call, when performed by the driver^ consists of a 
series of actions, operations, and events. An actioh or operation is 
something that the driver does and an event is something that the driver 
must react to. If you write an application program that includes CS/3000 
intrlnsics and the program doesn't woric as it is supposed to, it can be 
extremely difficult to pinpoint the problem without a record of the 
actions, operations, and events that occurred. The CS/3000 trace facility 
provides such a record. 

The trace facility is invoiced only at the user's reguest. Tracing can be 
Invoked for any or all communications lines that your program uses. The 
trace reguest is made either in the COPEN intrinsic call at the time a line 
is opened, in a :CLINE command prior to running your application program, 
or with a CCONTROL. 

Once it has been invoiced for a particular communications line, the trace 
facility continues to record line activity until the line is closed or a 
.CCONTROL with CONTROLCODE of 43 is executed. The trace facility keeps 
racJc of actions, operations, and events in the form of trace entries. The 
trace entries are grouped into trace records, each composed exclusively of 
CS/3000 intrinsic entries, protocol driver entries, or interconnect driver 
entries. The trace records are stored permanently in a file known as the 
trace file. The contents of a CS/3000 trace file can be formatted and 
printed through the use of a trace dump utility program that is described 
later in this section. 



3.1 DEFINING THE TRACE FILE 



The Trace Facility uses the file "CSTRAldn" as the trace file if no 
alternate file is specified by the user, where Idn is the logical device 
number of the line to be traced, 

PAPAMETER(l) Of CCONTROL 44 is used to specify an alternate trace file 
designator. This trace file designator will t\ave the logical device number 
of the line appended to it to ensure a unigue trace file for each line. 
The Idn is appended after the last character in the designator name if the 
name is less than five characters in length. If the designator name is 
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greater than or equal to five characters la length, the device number will 
replace characters 6 through n of the designator name. 

As an example, If the trace file designator "CSTRACE" is specified for Up^ 
line with Idn of 148, then the designator used will be '•CSTRA148''. \J 



6,2 INVOKING THE TRACE FACILITY 




To invoice the CS/3000 trace facility for a particular communications line, 
do one of the following: 

A. set bit (281) of COPTIONS to "I" in the COPEN intrinsic call that 
opens the line. 

B. Include the TRACE= parameter in a :CLINE command for the line 
prior to running your application program. 

C. execute a CCONTROL with CCONTROLCODE of 44. 

The trace facility will then be invoiced for the line (when the line is 
opened for either steps A or B of the above). 

Notes If a COPEN call in your application program requests tracing and you 
wish to suppress tracing for that line at run time, include 
NOTRACE parameter in a ;CLINE command for that line prior to runni 
your application program. Conversely, if a COPEN call in yol 
application program does not request tracing and you wish to request 
tracing for that line at run time, include the TRACEs parameter in a 
:CLINE command for that line prior to running your application 
program. 

In addition to invoking the trace facility, you can specify other 
trace-related information by using the CTRACEINFO parameter of the COPEN 
and CCONTROL intrinsic call. The format of the CTRACEINFO parameter is as 
follows? 

(Osl) = trace I/O errors only 
1 s trace all activities 

(iJl) s if the trace table is full, succeeding entries will be 
flushed. 
Is if the trace table is full# succeeding entries will 
overlay the prior entries. 

(2s6) = use driver default trace mask: 

>0 s trace mask indicating what types of trace entries 

are to be generated. The format of the trace mask for 

the BSC and MRJE protocols is as follows; 
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bit 2 = generate STN entries 

3 5 generate OPR and EDT entries ♦ 

4 s generate RCT entries ♦ 

5 = generate RTX entries » 

6 s generate SCT, POL, SEL entries ♦ 

7 s generate STX entries ♦ 

Note: CMP entries are automatically generated 

♦ default 

(10:1) = do not generate SCCP interconnect driver entries. 
1 = generate SCCP interconnect driver entries, 

(11:5) s use driver default maximum number of trace entries per 
record 
>0 ss maximum number of trace entries per trace record / 8 
(ie: to specify 8 entries/record, use 1) 

The CTRACEINFO parameters shown above can be specified instead (or altered) 
at run time by including the TRACE= parameter in a : Cl^INE command for the 
particular line prior to running your application program. 






The trace facility produces a series of trace records, each consisting of a 
eries of trace entries. If you specify that only I/O errors are to be 
raced, the trace facility will deposit in the trace file only those 

records in which an I/O error occurred. 



The types of trace entries mentioned under the CTRACEINFO parameter above 
(STN, CMP, OPR, interconnect, etc.) are described in detail later in this 
section. At this point it is sufficient to say that you can suppress the 
various types of trace entries, if you so desire. 

Trace entries are deposited in a trace record in a circular manner. For 
example, if you specify that there be a maximum of 35 trace entries per 
trace record, trace entries beyond the 35th will overlay the first, second, 
third, etc., trace entries in the record. If this happens, trace entries 
that have been overlayed will be missing from the listing and a warning 
message will appear at the start of the record in the listing telling you 
that the particular number of entries are missing. 

If the CTRACEINFO parameter is omitted from the COPEN intrinsic call, and 
if the corresponding parameters are not supplied in a :CLINE command, the 
drivers use the following default specifications: 

trace I/O errors only 

flush overflow trace entries 

generate all entry-types except STN 

do not generate SCCP interconnect driver entries 



jf"^\ 
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maximum of 25 trace entries per trace record 



o 



6.3 THE TRACE FILE 



Each line opened by your process that requires tracing will have their 
trace information written to the trace file specified, or to "CSTRAldn" if 
no name was specified. 

If tracing has been requested and the trace file is not yet open, the 
CS/3000 trace facility Issues an FOPEN intrinsic call with the following 
parameters; 



Parameter 



Value 



formal file designator 



CSTRACE 



FOPTIONS 



(1452) 

(13:1) 

(10!3) 
(8:2) 
(7:1) 
(6:1) 
(5:1) 
(0:5) 



11 







1 





(old file) 

(binary file) 

(use actual file designator) 

(fixed length records) 

(no carriage control) 

(disallow file equation) 



o 



AOPTIONS 



(12:4) 
(11:1) 
(10:1) 

(8:2) 
(0:8) 



(input/output access) 
(no multi-record option) 
(disallow dynamic 

loclclng/unloclcing) 
(exclusive access) 



blocicfactor 



If the trace file cannot be opened because it does not exists then a 
file will be opened in the system domain. 



new 



If an error occurs when trying to open the trace file, the particular COPEN 
intrinsic call will fail. 
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When the line Is closed, the cs/3000 trace facility Issues an FCLOS 
intrinsic call with the following parameters; 

Parameter Value 



filenum trace file number 

disposition l (save) 

seccode (unrestricted access) 



6,4 THACE DUMP PROGRAM 

There is a CS/3000 trace dump utility program CCSDUMP) in the syste 

library that will format and print the contents of trace files generated b 

the CS/3000 trace facility. The trace dump program requires a trace fil 
and a list file. 



6.5 List File 



The formal file designator of the list file is LIST. The list file may b 
defined as a CRT terminal, a line printer, or an old disc file. To defin 
the list file, enter an MPE :FILE command prior to invoicing the trace dum 
program. Some typical examples are as follows: 

:file LIST;DEVslP (LP is assumed to be the device class nam 

for one or more line printers) 

:FILE LIST;DEVsf iiename (filename is assumed to be the name of an ol 

job or system disc file) 



^%, 

^u^^' 
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It a list file is not defined by a sFILE command, the trace dump progj 
uses SSTDLIST as the list file. If a :FILE command is used to define 
list file, the file is opened as an old file. Should the file not exist, 
then it is opened as a new file in the system domain. After the dump 
program has run, the file is closed as a permanent file with unlimited 
access. The contents of this file may be examined by the HP/3000 editor, 
EDIT/3000, 



6,6 Invoking the Trace Dump Program 



After the 

commands 



trace and list files have been defined , enter the following 



5RUN CSDUMP,PUB.SyS;PARMsx 

The trace dump program uses the trace file as input and produces a 
formatted trace listing on the list file. The format of the trace file 
listing is specified by the PARM parameter of the RUN command: 



FARM Format 
0,1 List all trace file entries by 
time of occurance. 
2 List all CS/3000 intrinsic entries 
by time, with driver entries listed 
by time under their associated 
intrinsic entry. 
i List all CS/3000 intrinsic entries 
by time. 

The default for PARM is 0, A sample trace listing is shown in Figure 6-1, 



o 
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Figure 6-1. Sample Trace Listing- 
CS TRACE ANALYZER (A. 02. 00) MON, MAR 6, 1978, 12:45 AM 



c 



-TRACE FILE IS CSTRACE .PUB.MP 
\l ENTRIES DUMPED BY TIME 



LAST OPENED ON MON, MAR 6, 1978, 12:01 AM 
SYSTEM ID=32.17 



» BEGIN TRACING FOR DEVICE 32 ♦ 

♦ •L-I-N-E-— I-N-F-O-R-M-A-T-I-O-N— D-I-S-P-L-A-Y* 



LINE NUMBER: 4 LOGICAL 
DEV. type: 19 SUBTYPE: 

0123456789012345 
COPTIONS: 0010000010000001 
AOPTIONS: 0000000100001100 
DOPTIONS: 0000000000000000 



DEV. 
3 



NUMBER: 32 
VER: A. 02.00 



NUM8UFFERS5 1 
INSPEED: 300 
MISCARRAY: 



BUFFSIZE: 

OUTSPEED: 

RECEIVE TIMEOUT 



\i«^^'' 



DRIVERNAME: 
CTRACEINFO: 



PHONELIST: 
IDLIST: 
ERRORCODE: 
MSGSENT: 
RECOVERRORS: 



LOCAL TIMEOUT 

CONNECT TIMEOUT 

RESPONSE TIMEOUT 

LINE BID TIMEOUT 

NO. ERROR RETRIES 

CLEAR-TO-SEND DELAY 

DATA-SET-READY DELAY 

TRANSMISSION MODE 

MMSTAT TRACE FACILITY 

CSSBSCO LINESTATE 

ENTRIESS25 MASK=Ol 1 1 1 1 
TYPE OF TRACE = ALL, NOWRAP 
ENTRIESsO INDEXsO 
ENTRIESsO INDEXsO 
RECOVERABLE=0 IRRECOVERABLE=0 
MSGRECV: 
IRRECOVERRORS: 



512 (WORDS) 
300 

7200 SECS. 

7200 SECS. 

7200 SECS. 

3 SECS. 

60 SECS. 

7 

00.0 SECS. 

DISABLED 

HALF DUPLEX 

DISABLED. 

UNCONNECTED 



4(!|e:^4c4;4c4:«4(4c$:(c4(4()^)|t^4(4(](c$4c4ii»:4i^$;^«4:1:«%4c^'^^«'|E4c^4:4!4^!|(««^«')it 
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Figure 6*1, Sample Trace Listing. 

♦ CREAD REQUEST ID s 000505 ♦ 

♦ CALLER: SEGMENTsPRG 000 ADDRESSs 000122 ♦ 

♦ STATE: LINE STATEsDISCONNECT COPTIONSs 020201 DOPTIONSs 000000 ♦ 

♦ INPUT: IN BUFs 000076 LENGTH=-28 STATION 1=0 COMPONENT #=0 ♦ 

♦ OUTPUT: TRANSMISSION L0G=-4 STATION #sO COMPONENT »s0 ♦ 

1.722 POPR REQUEST ID= 000505(10145) 

WAIT FOR CONNECTION THEN RECEIVE CONTROL SEQ 

TIMEOUTS 7200.000 

IN BUFRs 0.021145 LENGTHs-16 

1 6.6U PRCT REQUEST IDs 000505(J0145) 

205.377 377.377 

2 6.612 PEDT REQUEST ID= 000505(10145) 

RECV ENQUIRY XLOGsO 

3 6.616 POPR REQUEST IDs 000505 ( J0145) 

SEND CONTROL SEQ THEN RECEIVE TEXT 
SEND SEQsID ACK TIMEOUT= 7200.000 
OUT BFRs 0.000000 LENGTHsO 
IN BUFRs 1.000044 LENGTHs-28 

4 6.617 PSCT REQUEST IDs 000505(50145) 

020.260 


5 6.725 PRTX REQUEST IDs 000505 ( J0145) 

020.002 120.060 070.040 020.203 026.240 377.000 

P 8 
377.377 

6 6.727 REDT REQUEST IDs 000505( i0145) 

RECV TEXT XLOGs-6 
200.000 120.060 070.040 
P 8 

7 6.730 PCMP REQUEST IDs 000505(10145) 

ERROR CODEsO LAST RECOVERABLE ERROR CPDEs 
#MSG SENTsO #MSG RECVsl STATEsTEXT 
# RECOVERABLE ERRaO t IRRECOVERABLE ERRsO 

4 1 If **4^***^*^*^**4****$**^**t****'¥t^**T^*^** ********************* 

* CCLOSE REQUEST ID s 000777 ♦ 

♦STATE: LINE STATEsTEXT COPTIONSs 020201 DOPTIONSs 000000 ♦ 
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c . 



figure 6-1. Trace Dump bisting 

8.912 POPR REQUEST ID= 000777 ( lOlFF) 

UNCONDITIONAL CLEAR OF ANY CURRENT OPERATION 

8.914 POPR REQUEST IDs 000777 ( lOlFF) 

SEND CONTROL SEQ THEN DISCONNECT 
SEND SEQsEOT TIMEOUTs 3.000 

8.915 PSCT REQUEST ID= 000777 ( lOlFF) 

026.004 



8.975 PCMP REQUEST IDs 000777 ( JOIFF) 

ERROR CODEsO LAST RECOVERABLE ERROR CODEs 
#MSG SENTsO «MSG RECVsl STATEsDISCONNECT 
« RECOVERABLE ERRsO # IRRECOVERABLE ERRsO 



♦ END OF TRACE FOR DEVICE 32 ♦ 



-l,-I«N-E — *I-N-F-0-R-M-A^T-I-0-N-— D-I-S-P-L-A-y* 
♦ ^^^♦♦♦♦♦* ♦♦♦♦♦♦♦♦»♦♦♦»♦♦♦*♦♦♦♦♦♦♦♦♦♦♦*♦♦♦♦ ♦♦♦♦♦♦♦ 



LINE number: 4 LOGICAL 
DEV. TYPES 19 SUBTYPES 

0123456789012345 
COPTIONSS 0010000010000010 
AOPTIONSS 0000000100001100 
DOPTIONSS 0000000000000000 



DEV. 
3 



NUMBERS 32 
VERS A. 02. 00 



NUMBUFFERSS 1 
INSPEEDS 300 
MISCARRAYS 



BUFFSIZES 
OUTSPEEDS 
RECEIVE TIMEOUT 



LOCAL TIMEOUT 

CONNECT TIMEOUT 

RESPONSE TIMEOUT 

LINE BID TIMEOUT 

NO. ERROR RETRIES 

CLEAR-TO-SEND DELAY 

DATA-SET-READY DELAY 

TRANSMISSION MODE 

MMSTAT TRACE FACILITY 



DRIVERNAMES 
CTRACEINFOS 

PHONELISTS 
IDLISTS 
ERRORCODES 
MSGSENTS 
RECOVERROPSS 



* 

* 
HALF DUPLEX. ♦ 



512 (WORDS) 
300 

7200 

7200 

7200 

3 

60 

7 

00.0 



SECS. 
SECS. 
SECS. 
SECS. 
SECS. 

SECS. 



DISABLED 



DISABLED. 
UNCONNECTED 



CSSBSCO LINESTATE 

ENTRIESS25 MASKsOlllU 
TYPE OF TRACE s ALL^NOWRAP 
ENTRIESsQ INDEXsO 
ENTRIESaO INDEXsO 
RECOVERABLEsO IRRECOVERABLE=0 
MSGRECVS 1 
IRRECOVERRORSS 



4tj^3^* *:>♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ ♦♦♦»♦♦♦♦♦ 
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figure 6-1, Trace Dump Listing 



END OF JOB. 



\,t^ 
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6.7 Trace Listing Header Message 

^ CS TRACE ANALYZER (A. 02. 00) MON, MAR 6, 1978, 12:32 AM 

TRACE FILE IS CSTRACE.PUB.MP 
ALL ENTRIES DUMPED BY TIME 

LAST OPENED ON MON, MAR 6, 1978, 12:01 AM 

SYSTEM ID=02.66 

At the start of the trace listing is a header message telling the date and 

time-of-day when the listing was printed, the fully-qualified name of the 

trace file being used, and the fo^rmat of the trace listing. The meanings 
of the two remaining items in the header message are as follows; 

LAST OPENED ON etc. This tells you the date and time-of-day when the 

trace was performed. 

SYSTEM IDsxx.yy This tells you the version number (xx) and fix 

level (yy) of the MPE/3000 operating system that 
was being used when the trace was performed. 
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6.8 "Begin Tracing" Message 



^4 it^^:^^^Tti4J(^:^}fli^^Tlf:^tt$*** ********* 

* BEGIN TRACING FOR DEVICE 32 ♦ 

^:lf^ilf4i$^:lliT^i^^*:$**r$t************** 



o 



^^^li:$l(^^^t******************************************* 
♦ •L-I-N-E— I-N-F-0-R-M-A-T-I-O-N— D-I-S-P-L-A-Y* 

ilf$^fli^;lli:^:^^:^^il^^*^:$i^*$t****** ************************ 



LINE NUMBER: 4 LOGICAL DEV* 
DEV. TYPE: 19 SUBTYPE: 3 

0123456789012345 
COPTIONS: 0010000010000001 
AOPTIONS: 0000000100001100 
DOPTIONS: 0000000000000000 



NUMBER: 32 
VER: A.02,00 



NUMBUFFERS5 1 
INSPEED: 300 
MISCARRAY: 



buffsize: 

outspeed: 

receive timeout 

local timeout 

connect timeout 

response timeout 

LINE BID TIMEOUT 

NO. ERROR RETRIES 

CLEAR-TO-SEND DELAY 

DATA-SET-READY DELAY 

TRANSMISSION MODE 

MMSTAT TRACE FACILITY 



drivername: 
ctraceinfo: 



CSSBSCO 



LINESTATE 



512 (MORDS) 
300 

7200 SECS. 

7200 SECS. 

7200 SECS. 

3 SECS. 

60 SECS. 

7 

00.0 SECS. 

DISABLED 



HALF DUPLEX.* 



DISABLED. 
UNCONNECTED 



ENTRIESS25 



MASKsOUlll 



TYPE OF TRACE s ALL, WRAP 



PHONELIST: 
IDLIST: 
ERRORCODE: 
MSGSENT: 
RECOVERRORS: 



ENTRIESsO 
ENTRIES=0 
RECOVERABLEsO 



INDEXsO 

INDEXsO 
IRRECOVERABLEsO 
MSGRECV: 
IRRECOVERRORS: 



o 



^t******************** **************************** 



The message "BEGIN TRACING FOR DEVICE etc." appears at each point in thf 
listing where a line to be traced is opened. The message tells you the 
decimal logical device number of the line (32 in the above example). It 
indicates that the particular line's activities are now being monitored bi 
the trace facility. It is followed by the PRINT'LINE'INFO "tombstone* 
describing the line's state when tracing started. 
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6.9 "End of Trace** Message 



* END OF TRACE FOR DEVICE 32 ♦ 

♦ «£,«I.N-E--*I-N-F-0-R-M»A-T-I-0-N---D-I-S-P-L-A-Y* 



LINE NUMBER: 4 LOGICAL 
DEV. TYPE: 19 SUBTYPE: 

0123456789012345 
COPTIONS: OOIOOOOOIOOOOOIO 
AOPTIONS: OOOOOOOlOOOOllOO 
DOPTIONS: 0000000000000000 



DEV 
3 



NUMBER: 32 
ver: a. 02. 00 



NUMBUFFEHS; 1 
INSPEED: 300 
MISCARRAY: 



BUFFSIZE: 

OUTSPEED: 

RECEIVE TIMEOUT 



LOCAL TIMEOUT 

CONNECT TIMEOUT 

RESPONSE TIMEOUT 

LINE BID TIMEOUT 

NO. ERROR RETRIES 

CLEAR-TO-SEND DELAY 

DATA-SET-READY DELA^ 

TRANSMISSION MODE 

MMSTAT TRACE FACILITY 



DRIVERNAME: 
CTRACEINFO: 

PHONELIST: 
IDLIST: 

errorcode: 
msgsent: 
recoverrors: 



* 
HALF DUPLEX.* 



512 (WORDS) 
300 

7200 

7200 

7200 

3 

60 

7 

00.0 



SECS. 
SEC5. 
SECS. 
SECS. 
SECS. 



SECS. 



DISABLED 



DISABLED. 
UNCONNECTED 



CSSBSCO LINESTATE 

ENTRIES=25 MASK=00010l 
T^PE OF TRACE s ERROR, NOWRAP 
ENTRIESsO INDEX=0 
ENTRIESsO INDEXsO 
RECOVER ABLEsO IRRECOVERABLE=0 
MSGRECV: 1 
IRRECOVERRORS: 



*♦♦♦♦♦♦»*»♦♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦*♦♦♦♦♦♦♦»*♦♦♦♦♦♦♦ 



The message "END OF TRACE FOR DEVICE etc." appears at each point In the 
listing where a line that is being traced is closed. The message tells you 
the decimal logical device number of the line (32 in the above example) and 
indicates that the particular line's activities are no longer being 
monitored by the trace facility. It is followed by the PRINT'LINE'INFO 
"tombstone" showing the line's state just before tracing was stopped. 



^^\^ 
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6.10 CS/3000 Intrinsic Entry Header Message 

^f 9>» wtim mi mm mi tm tm mttm 9t m wtmt tm m m m m tm tm mt m <"">» mxm mt mum f» mKm tmw) wt 

♦ CREAD REQUEST ID s 000505 t ^"^ 

♦ CALLER: SEGMENTsPRG 000 ADDRESS- 000122 ♦ 

♦ STATE: LINE STATE*DISCONNECT COPTIONS- 020201 DOPTIONS= OOOOOO ♦ 

♦ IMPUT: in BUFs 000076 LENGTH=-28 STATION #=0 COMPONENT #»0 ♦ 

♦ OUTPUT: TRANSMISSION L0G5-4 STATION #sO COMPONENT #a0 ♦ 

The trace listing is organized into a series of CS/3000 intrinsic entries 
and driver entries related to each intrinsic entry. The format of the 
listing is specified when the dump program is involced(see section 6.6) • 

The trace record header message specifies a reguest id used to identify 
driver entries related to the intrinsic call, the type of intrinsic, the 
location of the user's program where the intrinsic was invoiced, the line's 
state, and the user's calling parameters. 



6.U "Missing Entries" Message 



MISSING PROTOCOL ENTRIES 
MISSING INTERCONNECT ENTRIES 



o 



If the message "MISSING PROTOCOL ENTRIES" or "MISSING INTERCONNECT ENTRIES" 
appears in the listing it means that the specified record was not large 
enough to accomodate all of the trace entries and some entries were lost. 
If the tracing was performed with NOWRAP then the missing entires were at 
the end just before the PCMP entry or the IDX entry. Otherwise they are 
missing at the beginning. If the missing entries are crucial, do as 
follows: 

a. Purge the trace file, 

b. Change the "number of entries per record" specification by way of 
the TRACES, ,numentries parameter in a :CLINE command for the 
particular line. 

c. Re-run the application program. 
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6,12 Driver Trace Entry Format 

%^^ 8 B,852 POPR PEOUEST ID= 000505( i0145) 

SEND CONTROL SEQ THEN RECEIVE CONTROL SEQ 
SEND SEQsWACK TIMEOUTs 7200,000 
IN BUFP= 0.021145 LENGTH=1 

All driver entries In a trace listing contain a prefix consisting of four 
fields: 

1. an entry number (8 in the above example) 

2. a •*tlme stamp" in seconds and thousandths of seconds (8.852 in the 
above example) 

3. an entrytype mnemonic (POPR in the above example) 

4. a request id 

The first entry of each trace record is numbered ♦•O" and successive entries 
in the particular trace record are numbered consecutively in ascending 
order. 

The "time stamp" makes it possible for you to determine the elapsed time in 
seconds and milliseconds between one trace entry and another. Note: time 
stamp resolution for entries generated by an SCCP associated protocol 
driver is one hundredth of a second. 

The entry-type mnemonic tells you what type of trace entry you are 

examining. There are ten types of protocol driver trace entries and 

seventeen types of interconnect driver trace entries; they are summarized 
In Tables 6-1 and 6-2, 

The body of each trace entry tells you the pertinent information for the 
particular activity that has happened or is about to happen. This part of 
the trace entry is described in detail for each entry-type on the remaining 
pages of this section. 



o 
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Table 6-1. Protocol Driver Trace Entry Type Mnemonic Definitions 
MNEMONIC ENTRY TYPE DEFINITION |J^ 



POPR 



Operation 



PSTN 



State Transition 
Entry 



PEDT 



Editor Entry 



PRCT 



Receive Control 
sequence Entry 



PSCT 



send Control 
sequence Entry 



This type of trace entry is generated 
each time the physical driver is called 
upon to perform an operation. The POPR 
trace entry tells what operation is to 
be performed. 

This type Of trace entry is 
generated each time the driver 
transfers from one internal state to 
another. The PSTN trace entry tells 
what event just happened and what action 
is about to be performed. 



This type of trace 
each time a text 
character sequence 
remote station, 
message, the PEDT t 
first 13 (for HS 
words of the user 
Characters, pad 
parity sequences ar 
case of a contro 
the PEDT trace entr 
phrase telling what 



entry is generated 
message or control 
is received from the 
In the case of a text 
race entry shows the 
I) or 14 (for SSLC) 
's buffer; control 
characters, and CRC 
e omitted. In the 
1 character sequei 
y supplies a mnemol 

was received. 




This type of trace entry is 
generated each time a control character 
sequence is received from the remote 
station. The PRCT trace entry shows (in 
octal) byte-for-byte exactly what was 
received. 

This type of trace entry is 
generated each time the driver sends a 
control character sequence to the remote 
station. The PSCT trace entry shows (in 
octal) byte-for-byte exactly what was 
sent. 
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Table 6-1. Protocol Driver Trace Entry Type Mnemonic Definitions 



bwic 



ENTRY TYPE 



DEFINITION 



PPOL 



send Polling 
sequence Entry 



This type of trace entry is 
generated each time the driver sends a 
polling sequence. The PPOL sequence 
shows byte-for-byte the polling 
sequence. All BSC control characters 
(such as SYNs, EOT, and ENQ) are not 
shown. 



PSEL 



Send Selection 
sequence Entry 



This type of trace entry is 
generated each time the driver sends a 
selection sequence. The PSEL sequence 
shows byte-for-byte the selection 
sequence. All BSC control characters 
(such as SYNs, EOT, and ENQ) are not 
shown. 



PRTX 



Receive Text Entry 



CTX 



send Text Entry 



This type of trace entry is generated 
each time a text message is received 
from the remote station. The PRTX trace 
entry shows (in octal) byte-for-byte 
exactly what was received. 

This type of trace entry is generated 
each time the driver sends a text 
message to the remote station. The PSTX 
entry shows (in octal) byte-for-byte 
exactly what was sent. 



PCMP 



user Request 
Completed 



This type of trace entry is generated 
each time a user request (i.e., a CREAD, 
CWRITE, driver-performed CCONTROL, or 
CCL05E intrinsic call) is completed. 
The PCMP trace entry summarizes the 
number of text messages sent and 
received, the number of errors that have 
occurred, etc. 
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Table 6»2 Interconnect Driver Trace Entry Mnemonic Definitions 



MNEMONIC 



ENTRY TYPE 



DEFINITION 






IDC 



IDX 



lADQ 



IRFQ 



IDF 



lUNF 



NR 



IPR 



Driver Called 



Driver Exited 



Add to Queue 



Remove from Queue 



Data Frozen 



Unfreeze Data 



New Request 



Process Request 



This entry 
driver is 
operation. 



is generated 
called to 



whenever the 
perform an 



This entry is generated whenever the 
driver completes an execution of the 
main control routine. 

This entry is generated whenever the 
driver adds a request to one of its 
internal queues. 

This entry is generated whenever the 
driver removes a request from one of its 
internal queues. 

This entry Is generated whenever the 
driver requests a target data segment to 
be frozen In memory or to check If a 
previous request to freeze a data 
segment has been completed. 



lOUlL^ 



AR 



Abort Request 



Tnls entry is generated whenevei 
driver wishes to unfreeze a prev: 
frozen data segment or to Insure that a 
data segment associated with a request 
Is not frozen by the driver. • 

This entry Is generated each time the 
driver begins processing a new request. 

This entry Is generated whenever the 
driver processes a request which may be 
completed Immedlatelyde: requires no 
I/O to SCCP) or whenever a request 
requires some preprocessing before I/O 
is to be done. 

This entry Is generated whenever a 
request Is to be hard aborted. 
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Table 6-2 Interconnect Driver Trace Entry Mnemonic Definitions 

1 ^TO Start Timeout This entry is generated whenever the 

driver starts a software timeout on a 
request, 

iss Set Status This entry is generated whenever the 

request completion status is set, 

ICR Complete Request This entry is generated whenever a 

request has been fully completed by the 

driver and is released to the request 
initiator, 

ICC Check Completion This entry is generated whenever the 

driver calls the physical driver to 
check I/O completion status and to check 
for software timeout completions. 

IPM Process Message This entry is generated whenever the 

driver receives a message from SCCP. 

ippp Power Fail Recovery This entry is generated each time the 

power fail recovery routi*ne is called. 

ICD Call Driver This entry is generated each time the 

physical driver is called to perform an 
operation. 

IDIO Do I/O This entry is generated each time the 

driver wishes to do an operation which 
sends a message to SCCP or moves data 
to/from seep or moves data between 
requests, 

IRB Illogical condition This entry is generated whenever the 

driver detects an illogical internal 
condition or receives an erroneous or 
illogical message from SCCP, 
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6.13 POPR (Operand) Trace Entries 



6.616 POPR REQUEST IDs 000505(10145) 

SEND CONTROL SEQ THEN RECEIVE TEXT 
SEND SEQsID ACK TIMEOUTs 30.000 
OUT BFRs 0.000000 LENGTHsO 
IN BUFRs 1.000044 LENGTHs-28 



o 



A POPR trace entry Is generated each time the physical driver is called 
upon to perform an operation. 



The meanings of the various items are as follows: 

SEND CONTROL SEQ etc. This item tells you what operation is 



SEND SEQs 



TIMEOUTS etc. 



OUT BFRsx.XXXXXX 
IN BFRsx.XXXXXX 



This item tells 
performed. 



being 



This item tells you what control character 
sequence, if any, is about to be sent to the remote 
station (ID ACK in the above example). 

This item tells you the starting value of the 
applicable timeout timer. In the above example the 
driver sends an ID ACK to the remote station and 
then waits for a character response. "TIMEOUT* 
30.000" specifies that the response timeout timer 
will be activated and set to 30 seconds. 



This item specifies bank and banK offset of 
user/CS output buffer. 



vrrS 



This item specifies the bank and bank offset of the 
user/CS input buffer. 



LENGTHsy 



These two items specify the size (+=words;-sbytes) 
of the CS output and input buffers, respectively. 
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3,14 PSTN (State Transition) Trace Entries 



ib 



S.Xbl PSTN REQUEST IDs 000505(10145) 

EVENT IS RECEIVED WACK SEQUENCE 

ACTION IS SEND ENQ, GET TEXT/RESPONSE ( 033) 

RETRY COUNTER=0 STATE= 0640 

PENDING EVENTS 000000 EVENT MASKs 024000 



An PSTN trace entry Is generated each time the driver transfers from one 
internal state to another. 

The meanings of the various items are &s follows; 

EVENT IS etc. This line tells you what event Just occurred. Look 

up the event phrase (RECEIVED WACK SEQUENCE in the 
above example) in Table 6-2 for a detailed 
description. 



ACTION IS etc. 




ETR¥s 



STATES 



PENDING EVENTS 



EVENT MASKS 



This line tells you what action the driver is about 
to perform. The action number ( 033 in the above 
example) is of no concern to you and should be 
ignored. Look up the action phrase (SEND ENQ, GET 
TEXT/RESPONSE in the above example) in Table 6-3 
for a detailed description. 

This item tells you the current value of the retry 
counter. For certain error conditions, the driver 
increments the retry counter and then re-executes 
the operation in which the error occurred. 

This item tells you what driver state is to be 
entered next. 

This item tells you the current contents of bits 
0-7 of the word EXTERNAL'EVENT in the driver. 

This item tells you the current contents of bits 
8-15 of the word EXTERNAL'EVENT in the driver. 
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6.15 PEDT (Editor) Trace Entries 

b 6,727 PEDT REQUEST IDs 000505( J0145) /*| 

BECV TEXT XLOGs-6 ^>^ 

200.000 120.060 070.040 
P 8 

PEDT trace entries are generated in conjunction with received text messages 
and received control character sequences. 

in the case of a received text message, the body of an EDT trace entry 
shows in octal the first 13 (for HSI) or 14 (for SSLC) words of the text 
message. Regardless of how long the text message is, only one PEDT trace 
entry will be generated per received text message. The text message is 
shown as it appears in the user's buffer: control characters, pad 
characters, and CRC parity sequences are omitted. XLOG specifies the total 
number of words or bytes (+3words;-=bytes) deposited into the user's 
buffer. If the MFW (1 word or 2 bytes) is used then it is also included 
in XLOG. 

In the case of a received control character sequence, the PEDT trace entry 
includes a mnemonic phrase telling what control character sequence was 
received. If the control character sequence was accompanied by an ID 
sequence, the ID sequence is shown in octal below the mnemonic phrase. 
XLOG will normally be zero, except in the case when an ID sequence was also 
received, in the latter case, XLOG specifies the length of the ID sequence 
(>swords;-abytes). ^^ 

Wherever possible, the trace dump program converts the received octal codes 
to a character and displays the character beneath its code. The 
translation from code to character is performed properly for EBCDIC 
transmissions as well as ASCII transmissions. 

In the example above (RECV TEXT), the body of the PEDT trace entry is 
interpreted as follows: 

A text message was received from the remote station. The total number 
of data characters received was 4 (XLOGs-4). The 4 data characters 
received are 

120 s P 060 a 
070 a 8 040 = space 
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6.16 PRCT (Receive Control sequence) Trace fc:ntries 



c 



1,026 PRCT REQUEST IDs 00050& ( iOUb) 
020,260 377.377 




An PRCT trace entry ts generated each time a control character sequence is 
received from the remote station. The body of an PRCT trace entry shows 
you byte-for-byte exactly what was received (i.e., the actual contents of 
the driver^s internal buffer). 

control character sequences are terminated by a trailing pad character (377 
octal). When interpreting the body of an PRCT trace entry, ignore anything 
following the 377 code. 

In the above example, an ACKO control character sequence was received. The 
octal codes are interpreted as follows: 



020 s DliE 

260 * (060 with parity bit set) 

377 s trailing pad character 



ACKO sequence 



Wherever possible, the trace dump program converts the octal codes to a 

Character and displays the character beneath its code. The translation 
from code to character is performed properly for EBCDIC transmissions as 
well as ASCII transmissions. 

Notes The trace facility will not generate PRCT trace entries it the HSI 

driver Is being used. In such a case, to trace received control 

character sequences PEDT trace entries must be generated. 



■ 
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6.17 PSCT (Send Control Sequence) Trace Entries 

5 0.956 PSCT REQUEST IDs 000777 ( 'OlEF) Y^ 

205.377 ^-^ 

An PSCT trace entry is generated each time the driver sends a contro 
character sequence to the remote station. The body of an PSCT trace entr 
shows you byte-for-byte exactly what was sent to the remote station (i.e. 
the actual contents of the driver's internal buffer). 

In the above example, an ENQ control character was sent. The octal code 
are interpreted as follows; 

205 = ENO (005 with parity bit set) 

377 s PAD (This is the traillnq pad character) 

Wherever possible, the trace dump program converts the octal codes to 
character and displays the character beneath its code. The translation 
from code to character is performed properly for EBCDIC transmissions a 
well as ASCII transmissions. 



o 
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6.18 PPOL (Send Polling Sequence) Trace Entries 



c 



6 3.807 PPOL REQUEST ID= 0007 77 ( I OlFF) 

301.301 302.302 
A A B B 

A PPOL trace entry Is generated each time the driver sends a polling 
sequence to the remote group/station. The body of a PPOL trace entry shows 
you byte-for-byte the polling sequence sent on the line. It does not show 
the BSC control characters that accompany the polling sequence such as SYN, 
EOT, and ENO. 

In the above example, the polling sequence was the ascll string, AABB. 

Wherever possible, the trace dump program converts the octal codes to a 
character and displays the character beneath Its code. The translation 
from code to character Is performed properly for EBCDIC transmissions as 
well as ASCII transmissions. 
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6.19 PSEL (Send Selection Sequence) Trace Entries 

3 4.096 PSEL REQUEST ID= 000777(J0iFF) C\ 

103.103 304.304 ^-^ 

C C D D 

A PSEL trace entry is generated each time the driver sends a selection 
sequence to the remote group/station. The body of a PSEL trace entry shows 
you byte«for«byte the selection sequence sent on the line, it does not show 
the BSC control characters that accompany the selection sequence such as 
SYN, EOT, and ENQ. 

in the above example, the selection sequence was the ascii string, CCDD. 

Wherever possible, the trace dump program converts the octal codes to a 
Character and displays the character beneath its code. The translation 
from code to character is performed properly for EBCDIC transmissions as 
well as ASCII transmissions. 



o 
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6,20 PRTX (Receive Text) Trace Entries 



( 



5 6.725 PRTX REQUEST ID= 000777 ( iOlFF) 

020.002 120,060 070.040 020.203 026.240 377 
P 8 

PRTX trace entries are generated each time a text message is received from 
the remote station. The body of an PRTX trace entry shows you 
byte-for-byte exactly what was received (i.e., the actual contents of the 
driver's internal buffer). 

Text messages are terminated by a two-byte CRC (cyclic redundancy checic) 
parity sequence followed by a trailing pad character (377 octal), when 
interpreting the body of an PRTX trace entry, ignore anything following the 
377 code. 

In the above example^ the octal codes are interpreted as follows: 

020 a OLE 002 s STX 

120 s P 060 5 

070 a 8 040 » space 

020 « DLE 203 = ETX (003 with parity bit set) 

026 s 240 = 

CRC parity sequence 

377 = trailing pad character 

Each PRTX trace entry can show a maximum of 32 bytes. If a text message 
exceeds this length, as many successive PRTX trace entries will be 
generated as are necessary. 

wherever possible, the trace dump program converts the octal codes to a 
character and displays the character beneath its code. The translation 
from code to character is performed properly for EBCDIC transmissions as 
well as ASCII transmissions. 

Note: The trace facility will not generate PRTX entries if the HSI driver 
is being used. In such a case, to trace received text messages PEDT 
trace entries must be generated. 
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.21 PSTX (Send Text) Trace Entries 

13 1,037 PSTX REQUEST IDs 000505(10145) ^p^ 

020.002 120.060 070.040 020.203 026.240 377 f 1 

P 8 ^*^ 

PSTX trace entries are generated each time the driver sends a text message 

to the remote station. The body of an PSTX trace entry shows you 

byte-for-byte exactly what was sent to the remote station (i.e., the actual 
contents of the driver's internal buffer). 

In the above example, the octal codes are interpreted as follows: 

020 s OLE 122 sR 

002 s STX 040 = space 

120 s P 060 = 

070 s 8 040 = space 

020 s OLE 203 = ETX (003 with parity bit set) 

026 s 240 = 

CRC parity sequence 

J 
Each PSTX trace entry can show a maximum of 32 bytes. If a text message 
exceeds this length, as many successive PSTX trace entries are generated as 
are necessary. The above example is such a case and was continued into 
another PSTX trace entry. 

Wherever possible, the trace dump program converts the octal codes to a 
Character and displays the character beneath its code. The translation 
from code to character is performed properly for EBCDIC transmissions as 
well as ASCII transmissions. 

Notes The Trace Facility will only trace the first 32 bytes of sent text 
if the HSI driver is being used. 



c 
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6.22 PCMP (I/O completion) Traqe Entries 



( 



I'l i,i32 PCMP REQUEST ID= 0O0505( i0145) 

ERROP CODE=2iO LAST RECOVERABLE ERROR CODE= 
#MSG SENTsO »MSG RECVsO STATE»CONTROL 
# RECOVERABLE ERRsO # IRRECOVERABLE ERR^O 



A PCMP trace entry is generated each time a user request (l.e.# a CREAD, 
CWRITE, driver-performed CCONTROL, or CCLOSE intrinsic cali) is completed. 
The meanings of the various items are as follows: 



Error CodesX 



Last Recoverable Error CodesX 



XXX is the error code of the request's most 
recent recoverable error. See Section 4.12 
of this manual. 

If a recoverable error occurred, x is its 
error code. See section 4,13 of this 
manual. 



#MSG SENT-X 



»MSG RECV=X 



^RECOVERABLE ERRsX 



X specifies the total number of text 

messages that have so far been sent for this 
connection. 

x specifies the total number of text 

messages that have been received so far for 
this connection. 

X specifies the total number of recoverable 

errors that ^^i^^^^ occurred so far for this 
connection. 



#IRRECOVERABLE ERRsX 



STATES 



X specifies the total number of 
irrecoverable errors that have occurred so 
far for this connection. 

This item specifies what line state the line 
is in after the completion of the user 
request (CONTROL state in the above 
example). 



o 
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,xx lADQ (Add Request to Queue) Trace Entries 

3 7.075 lADQ REQUEST ID= OOOSOSt 10145) QUEUEsACTIVE QUEUE LENsS 

FUNCTIONsREAD ERRORCODEsO 






An lADQ trace entry Is generated whenever the driver adds a request to one 
of Its Internal queues. 

The meanings of the various items are as follows: 

REQUEST IDs etc. This item tells you the id of the request 

responsible for this driver action. Id values 
are given in octal and hex. 

QUEUES etc. This item tells you the queue to which the 

request is added. 

QUEUE LENsy This item specifies the number of requests 

queued to the above queue. 

FUNCTIONa etc. This item tells you the SCCP function specified 

in the request. 

ERRORCODEsX This item specifies an irrecoverable error code 

as defined in Chapter 4. 



!_./ 
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x.xx JHFg (Remove Request From Queue) Trace Entries 



( 



7,075 IRFQ REQUEST ID^ 000505(10145) QUEUEsACTIVE QUEUE LEN=5 
FUNCTIONsREAD ERRORCODEsO 



An IRFQ trace entry is generated wnenever the driver removes a request from 
one of Its internal queues. 

The meanings of the various items are as follows: 



REQUEST IDs etc. 

QUEUES etc. 
QUEUE LENsy 
FUNCTIONS etc. 
EPRORCODEsX 



^F*\ 



This item tells you the id of the request 
responsible for this driver action. Id values 
are given in octal and hex. 

This item tells you the queue to which the 
request is removed. 

This item specifies the number of requests 
queued to the above queue. 

This item tells you the SCCP function specified 
in the request. 

This item specifies an irrecoverable error code 
as defined in Chapter 4. 
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,xx INR (New Request) Trace Entries 



3,034 INR REQUEST ID= 000777 ( iOlFF) QMISC= 000001 PCB#= Ot3 
FUNCTIONsINFO TRANSFER 



^Hjlgl^^ 



An INR trace entry is generated each time the driver begins processing a 
new request. 

The meaning of the various items are as follows: 

REQUEST IDS etc. This item tells you the Id of the request 

responsible for this driver action. Id values 
are given in octal and hex. 

QMISCss xxxxxx This item tells you the miscellaneous parameter 

associated with the request. 

PCB«= XXX This item specifies the PCB number of the 

originator of the request. 

FUNCTIONS etc. This item tells you the SCCP function specified 

in the request. 
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x.xx IPR (Process Request) Trace Entries 



( 



8 3,034 IPR REQUEST IDs 000777 ( lOlFF) QMISCs 000000 PCB#= 013 

FUNCTIONsINFO TRANSFER 

An IPR trace entry Is generated whenever the driver processes a request 
which may be completed immediatelyde requires no I/O to 5CCP) or whenever 
a request requires some preprocessing oetore I/O Is to be done. 

The meaning of the various items are as follows: 

REQUEST IDs etc. This item tells you the Id of the request 

responsible for this driver action. Id values 
are given in octal and hex. 

QMISCs xxxxxx This item tells you the miscellaneous parameter 

associated with the request. 

PCB#= XXX This item specifies the PCB number of the 

originator of the request. 

FUNCTIONS etc. This item tells you the SCCP function specified 

in the request. 



p-^ 
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XX lAR (Abort Request) Trace Entries 

9 8.173 lAR REQUEST IDs 000505( J0145 ) 



FUNCTIONsREAD ERRORC0DEsl02 

An lAR trace entry Is generated whenever a request is to be hard aborted. 

The meanings of the various items are as follows: 

REQUEST IDs etc. This item tells you the id of the request 

responsible for this driver action. Id values 
are given is octal and hex. 

FUNCTIONS etc. This item tells you the SCCP function specified 

in the request. 

ERRORCODEsx This item specifies the irrecoverable error code 

as defined in Chapter 4. 



o 



\ 
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x,xx ISTO (Start Timeout) Trace Entries 

to 8.173 ISTO REQUEST IDs 000777 ( i OlFF) FUNCTIONsWRITE 



c 



An ISTO trace entry Is generated whenever the driver starts a software 
timeout on a request. 

The meanings ot the various items are as follows: 

REQUEST IDs etc. This item tells you the id of the request 

responsible for this driver action. Id values 
are given in octal and hex. 

FUNCTIONS etc. This item tells you the SCCP function specified 

in the request. 
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XX IRB (Illogical Condition) Trace Entries 

18 6.543 IRB REQUEST IDsNONE ^ ^^^ 

LOGICAL DRVR ERRORCODE=0 PHYSICAL DRIVER ERR0RC0DE=3 |^ 

An IRB trace entry is generated whenever the driver detects an illogical 
internal condition or receives an erroneous or illogical message from SCCP. 

The meanings of the various items are as follows: 

LOGICAL DRVR ERRORCODE=X This item tells you the code of the catastrophic 

error detected by the logical driver. 

PHYSICAL DRVR ERRORCODEsx This Item tells you the code of the catastrophic 

error detected by the physical driver. 
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Table 6^2. Trace Kntry EVfc:NT Definitions 



\( 



EVENT 



BORT CURRENT USER REQUEST 



DEFINITION 



The current intrinsic call must be aborted. 
ALL STATIONS DOWN No Stations or groups can 
be polled or selected because errors have 
occurred on every station or group listed in 
the polling sequence or for the selected 
station. 



BROADCAST TO ALL STATIONS 



Broadcast text to either all stations on the 
line or all stations in a particular group 
(see STATION parameter in the CWRITE 
heading). 



CARRIER LOSS 



The communications link with the remote 
station has been broken. 



CCLOSE 



A CCLOSE intrinsic call has been 
encountered. The driver is to be closed. 



CCONTROL 



A CCONTROL intrinsic has been encountered. 
The driver is to perform the specified 
control function. 



CONNECT TIMEOUT EXPIRED 



TA OVERRUN OCCURRED 



The line was not physically connected within 
the maximum time allowed. 

Before a received data word could be 
transfered from the TCU to main memory, it 
was overrwritten by the next received data 
word. 



DATASET NOT RDY 



The "Data Set Ready** (CO signal from the 
MODEM changed from "set" to "clear". 



HARDWARE FAILURE OCCURRED 



A hardware error was detected. The failure 
occurred in the local station^ not the 
remote. 



INITIALIZE 



A COPEN intrinsic call has been encountered. 
The driver is to be initialized. 



INTERNAL TIMEOUT EXPIRED 
LAST ACTION WAS SUCCESSFUL 



The driver must transmit a WACK or TTD. 

The action specified in the previous STN 
trace entry was performed successfully. 



c 
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Table 6-2, Trace Entry EVENT Definitions (Cont.) 



EVENT 



LAST ACTION WAS UNSUCCESSFUL 



LOCAL TIMEOUT EXPIRED 



DEFINITION 



NO ID VERIFICATION 
NON RESP DEVICE 

POWER FAIL OCCURRED 

PUT REMOTE IN CONTROL STATE 

READ INTERRUPT 

READ (INPUT BUFFER) 
READ (NO BUFFER) 

READ REPEAT 

RECEIVE ID THEN SEND ID 



RECEIVE TIMEOUT EXPIRED 



RECEIVED ACKO SEQUENCE 



The action specified in the previous STN 
trace entry was not performed successfully* 



A CREAD or CWRITE intrinsic call was not 

issued within the maximum time allowed 

following a previous CREAD or CWRITE 
intrinsic call. 

No ID verification is to be performed. 

Non-responding local TCU (i.e^f HSI or 
SSLC). 

A power failure was detected. 

Return station to control state so that 
another station can be polled or selected. 

A CREAD is to be performed. An RVI is to be 
sent to the remote rather than an ACK. 

A CREAD is to be performed. 

A CREAD with no input buffer is to be 
performed. 

A CREAD is to be performed. A NAK is to be 
sent to the remote instead of an ACK. 

ID verification is to be performed on this 
line. The local station is to first receive 
and verify the remote's ID. It then sends 
its ID to the remote. 

Nothing (including TTD) was received from 

the remote station within the maximum time 

allowed during a read operation. Note that 
a TTD always resets the timer. 

An ACKO control character sequence (positive 
acknowledgement) was received from the 
remote station. 
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Table b-2. Trace Entry EVENT Definitions (Cont.) 



Srf 



EVENT 



ECEIVED ACKl SEQUENCE 



RECEIVED DLE EOT SEQUENCE 



RECEIVED ENO 



RECEIVED EOT 



RECEIVED GARBAGE CHARACTERS 



RECEIVED NAK SEQUENCE 



RECEIVED RVI SEQUENCE 



#^, 

V 



CEIVED TEXT 



RECEIVED TEXT BLOCK 



RECEIVED TEXT IN ERROR 



RECEIVED TEXT OVERFLOW 



DEFINITION 

An ACKl control character sequence (positive 
acknowledgement) was received from the 
remote station. 

A DLE EOT control character sequence 
(disconnect sequence) was received from the 
remote station. 

An ENQ control character was received from 
the remote station. 

An EOT control character was received from 
the remote station. 

Data was received from the remote station 
but was unrecognizable. 

A NAK control character sequence (negative 
acknowledgement) was received from the 
remote station. 

An RVI control character sequence ("reverse 
interrupt" positive acknowi- edgement) was 
received from the remote station. 

A text message (with no errors) was received 
from the remote station. 

A text message, ending with an end-of-text 
block character was received from the 
remote. The remote wants to send more text. 

A text message was received from the remote 
station. However, a parity error was 
detected. 

A text message was received from the remote 
station. However, the message length 
exceeded that specified by the INCUUNT 
parameter of the CREAD intrinsic call and 
overflow occurred. Note that in such cases 
the driver cannot perform parity error 
checking. The received text should be 
considered unreliable. 
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Table 6-2, Trace Entry EVENT Definitions (Cont.) 



EVENT 



RECEIVED TTD SEQUENCE 



RECEIVED WACK SEQUENCE 



DEFINITION 



RESPONSE TIMEOUT EXPIRED 



SAME STATION AS BEFORE 



SELECT THE STATION 



SEND DISCONNECT 



SEND ID THEN RECEIVE ID 



A TTD control character sequence ("temporarV 
text delay") was received from the remote 
station during a read operation. 

A WACK control character sequence ("wait 
before transmitting" positive acknowl- 
edgement) was received from the remote 
station during a write operation. 

No acknowledgement was received from the 
remote station within the maximum time 
allowed. Note that a WACK control character 
always resets the timer. 

Transmit data to or receive data from the 
same station as the last request. 

Select a particular station on a multipoint 
line, 

A CCONTROL intrinsic call with C0NTR0LC0DEs2 
has been encountered. The driver is to 
perform a "Send Disconnect" operation. 



m^^j^ 



ID verification is to be performed on thi 
line. The local station is to first sen 
its ID to the remote and then receive the 
remote's ID. 






SEND RESET 



SEND TO DIFFERENT STATION 



SYSTEM CONTROL REQUEST 



A CCONTROL intrinsic call with CONTROLCODEsI 
has been encountered. The driver is to 
perform a "Send Reset" operation. 

The station specified by the request's 
STATION parameter is different from the 
currently polled/selected station. 

A request for a START TRACE, STOp TRACE, or 
STOP FLUSH function has been encountered. 
The driver is to perform the specific 
function. 
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Table 6«2, Trace Entry EVENT Definitions (Cont.) 



EVENT 



fSTEM INFORMATION TRANSFER 



DEFINITION 



A request for a CGETINFO, CCHECK, or SHOWCOM 
information transfer to/from the mainframe 
has been encountered. The driver is to 
perform the specific transfer. 



TRANSFER ERROR 



A local TCU (i.e., HSI or SSLC) transfer 
error was detected. 



WRITE (CONVERSATIONAL) 



A CWRITE is to be performed having an input 
and an output buffer. 



WRITE (NO BUFFER) 



WRITE (OUT BUFFER) 



A CWRITE is to be performed having no input 
or ouput buffer. 

A CWRITE is to be performed having on output 

buffer but no input buffer, operation. 



^"^ 
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Table 6-3 



Trace Entry ACTION Definitions 



ACTION 



o 



DEFINITION 



ABORT THE REQUEST 
BID FOR THE LINE 



BREAK CONNECTION 



BROADCAST TO ALL TRIBUTARIES 

DISCONNECT 

EXEC LAST REOrREsEOT IN CNTL 



EXEC LAST REO,REsINVALID ID 



EXEC LAST REQ,RE=RECV GARBGE 



The driver is to abort the current intrinsic 
call and process the next user request. 

The driver is to bid for the line (i.e., 
send an ENQ to the remote station and then 
receive a response; the expected positive 
response Is an ACKO sequence). 

A CGLOSE Intrinsic call has been 
encountered. If the communications link 
with the remote station currently exists, 
the driver Is to send either a DLE EOT 
sequence (switched line) or an EOT 
(non-switched line) to the remote station 
and then disconnect the line. 

send text to all stations on the line. 



iaracte#~\ 
tatlonVJ^ 



Initiate disconnect sequence. 

An EOT was detected In a control chai 
sequence received from the remote s 
The driver Is to re-execute the latest 
physical driver request (I.e., the OPERATION 
specified In the previous OPR trace entry). 

An Invalid ID sequence was received from the 
remote station. The driver is to re-execute 
the latest physical driver request (I.e., 
the OPERATION specified In the previous DVR 
trace entry) . 

An unrecognizable text message or control 
character sequence was received from the 
remote station. The driver Is to re-execute 
the latest physical driver request (I.e., 
the OPERATION specified In the previous DVR 
trace entry). 
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Table 6-3. Trace Entry ACTION Definitions (Cont.) 



ACTION 



DEFINITION 



EXfeX LAST REQ,REsREO RSP RSND 



EXECUTE CCONTROL REQUEST 



EXEC SYSTEM CONTROL REQUEST 



EXEC SYSTEM INFORMATION TRANSFER 



FREEZE I.D. LIST 



O 



lEEZE THE BUFFER 



The remote station has asked the local 
station to resend its latest response. The 
driver is to re«execute the latest physical 
driver request (i.e., the OPERATION 
specified in the previous OpR trace entry). 

A CCONTROL intrinsic call has been 
encountered. The driver is to perform the 
specified control function. 

A request for a START TRACE, STOP TRACE, or 
STOP FLUSH has been encountered. The driver 
will perform the specific function. 

A request for a CGETINFO, CCHECK, or SHOWCOM 
information transfer to/from the mainframe 
has been encountered. The driver will 
perform the specific transfer. 

The driver is to freeze the line's MISC Data 
Segment which contains the I.D. List. 

The driver is to freeze the user's stacic 
(NUMBUFFERSsO) or freeze the CS buffer 
(NUMBUFFEHS>0) in preparation for a data 
transfer operation. 



GENERATE CURRENT USER REQ 



The driver is 
intrinsic call. 



to 



recall 



the 



current 



GENERATE CURRENT WRITE REQ 



The driver is to recall the current CWRITE 
intrinsic call. 



GENERATE REQUEST OR ABORT 



GET TYPE OF ID CHECKING 



The driver is to recall the current 
intrinsic call, unless a soft ' abort was 
received, in which case an abort . should be 
performed. 

Test the kind of ID checking to be performed 
- read, write, or no checking. 
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Table 6-3. Trace Entry ACTION Definitions CCont.) 



ACTION 



DEFINITION 



o 



INC RETRY CTrREsATTMPT LBID 



The local station is the primary station and 
has received an ENQ in response to its line 
bid. The driver is to increment the retry 
counter and then either retry the line bid 
(if the allowable number of retries has not 
been exceeded) or perform the "POST LINE BID 
PREEMPTED" action described later In this 
table. 



INC RETRY CT,RE»BAD ACK 



The local station has received the wrong 
positive acknowledgement (i.e., ACKO when 
ACKl was expected, or vice versa). The 
driver is to increment the retry counter and 
then either resend the latest text message 
(if the allowable number of retries has not 
been exceeded) or perform the "POST MAX 
RETRIES" action described later in this 
table. 



INC RETRY CT,REaENQ TO TEXT 



The local station received an ENQ as the 
response to a text message. The driver is 
to increment the retry counter and then 
either resend the latest text message (i 
the allowable number of retries has not bee 
exceeded) or perform the "POST MAX RETRIES" 
action described later in this table. 



n^ 

If 



INC RETRY CTrREsGARBGE TO TX 



The local station received a garbled 
response to a text message. The driver is 
to increment the retry counter and then 
either resend the latest text message (If 
the allowable number of retries has not been 
exceeded) or perform the "POST MAX RETRIES" 
action described later in this table. 
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Ta^le 6-3. Trace Kntry ACTION Definitions (Cont.) 



ACTION 



DEFINITION 



INC HETRY CT,RE=INVALID ID 



INC PETPV CT,RE»NO RESP TO ENO 

INC RETRY CT,RE5RECV ENQ 
INC RETRY CT,RE=RECV GARBAGE 



t/C RETRY CT,REsREQ TXT RSND 



INC RETRY CT,RE=RESP TIMEOUT 



An invalid ID sequence was received trom the 
remote station. The driver is to increment 
the retry counter and then either retry the 
line bid (if the allowable number of retries 
has not been exceeded) or perform the "POST 
MAX RETRIES" action described later in this 
table. 

The remote did not respond to the ENQ sent 
by the local. 

The remote sent an ENQ, 

A garbled text message or control character 
response was received from the remote 
station. The driver is to increment the 
retry counter and then either ask the remote 
station to resend the message or response 
(if the allowable number of retries has not 
been exceeded) or perform the "POST max 
RETRIES" action described later in this 
table. 

The remote station has asiced the local 
station to resend its latest text message. 
The driver is to increment the retry counter 
and then either resend the latest text 
message (if the allowable number of retries 
has not been exceeded) or perform the "POST 
MAX RETRIES" action described later in this 
table. 

No acknowledgement was received from the 
remote station within the maximum time 
allowed. The driver is to Increment the 
retry counter and then either ask the remote 
station to resend its latest response (if 
the allowable number of retries has not been 
exceeded) or perform the "POST MAX RETRIES" 
action described later in this table. 



o 
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Table 6-3, Trace Entry ACTION Definitions (Cont.) 



ACTION 



DEFINITION 



o 



INC PETRY CT/REsTEXT ERROR 



INC RETRY CT^REaTXT OVERFLOW 



INITIALIZE THE DRIVER 
LAST TRIBUTARY SENT TEXT 

MRJE READ CONTINUE 

NO OPERATION 
POLL 

POLL (START WITH CURRENT STA) 

POST ALL STATIONS DOWN 



The text received from the remote has a bad 
check Character and the local must reject. 

Either the remote station sent text which 
was larger then the input buffer or the 
ETX/ETB delimiter was garbled. The driver 
is to increment the retry counter and then 
either ask the remote station to resend its 
text (if the allowable number of retries has 
not been exceeded) or perform the "POST MAX 
RETRIES" action described later in this 
table, 

A COPEN intrinsic call has been encountered. 
The driver is to be initialized. 

Text was received from the current station 
even though an attempt was made to put it 
back into control mode by sending it an RVI. 

Reset the ACK counters. (MRJE protocol uses 
only ACKO's.) Continue the last operation^.-. 
(Read). IJ 

No action is to be performed. 

Poll the requested station(s) to complete 
the CREAD request. 



Poll the requested station(s) starting 
the current station. 



with 



An attempt has been made to read from the 
list of stations or groups specified in tne 
current CREAD intrinsic or an attempt has 
been made to write to the station or to 
broadcast to the line as specified in the 
current CWRITE intrinsic. However, because 
all appropriate stations have been marked 
down in previous reads and writes, this 
request cannot be satisfied. 
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Table 6*3. Trace Entry ACTION Definitions (Cont.) 



ACTION 



DEFINITION 



POST BROADCAST DONE 



POST EXHAUSTED POLLING 



POST HARDWARE FAILURE 



POST INVALID REQUEST 
POST LINE BID PREEMPTED 



POST MAX RETRIES, DISCONNECT 



POST MAX RETRIES, SEND EOT 



POST NO LINE BID RECEIVED 



The request to send text to all stations has 
been completed successfully. 

No stations have had data to send and the 
requested number of iterations through the 
poll list have been completed. 

A hardware failure has occurred with the 
modem or TCU. The driver Is to disconnect 
the line, report the specific hardware 
problem to the user program, and process the 
next user request. 

The current intrinsic call is invalid. 

If the local station is the primary station, 
this means that the remote station 
continually responded with an ENQ when the 
local station was bidding for the line 
(i.e., the retry counter overflowed). 

If the local station is the secondary 
station, this means that the remote station 
responded with an ENQ when the local station 
tried to bid for the line. 

In either case, the driver is to process the 
next user request. 

The maximum number of allowable retries has 
been exceeded. The driver is to disconnect 
the line, post the error, and then process 
the next user request. 

The maximum number of allowable retries has 

been exceeded. The driver is to send an EOT 

control Character to the remote station, 

post the error, and then process the next 
user request. 

The local expected to receive a line bid but 
none were received from the remote. 
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Table 6-3. Trace Entry ACTION Definitions (Cont.) 



ACTION 



DEFINITION 






POST OPERATION FINISHED 



POST READ BUFFER OVERFLOWED 



The current intrinsic call has been 
completed. The driver is to process tne 
next user request. 

A text message was received from the remote 
station. However* the message length 
exceeded that specified by the INCOUNT 
parameter of the CREAD intrinsic call and 
overflow occurred. Note that in such cases 
the driver CANNOT perform parity error 
checlcing. The received text should be 
considered unreliable. The driver is to 
process the next user request. 



POST READ REQUEST SUCCESSFUL 



The current CREAD intrinsic 
performed successfully. 



call was 



POST RECEIVE TIMEOUT 



POST RECEIVED UNEXPECTED RVI 



POST RECEIVE UNEXPECTED TEXT 



Nothing (Including TTD) was received from 
the remote station within the maximum time 
allowed during execution of a read 
operation. Note that a TTD sequence always 
resets the timer. The driver is to process 
the next user request. 

An RVI was received from the remote although 
the local is sending text in blocks and not 
all of the blocks have been sent. 

The remote sent text and the local user did 
not provide an input buffer to receive it. 
The driver is to process the next request. 
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Table 6*3, Trace Entry ACTION Definitions (Cont.) 
ACTION DEFINITION 



POST RECV UNEXPECTED EOT 



POST REMOTE NOT READY 



POST REM PROTCL ERR, DISCNCT 



POST REM PROTCIi ERR, SND EOT 



POST REMOTE REJCTD CONNECTN 



POST REMOTE REJECTD LINE BID 



o 



POST REMOTE SENT DELAY SEO 



POST REMOTE SENT EOT 



POST REQUEST ABORTED 



POST RETRY OVERFLOW 



An EOT was received although the local has 
not yet sent all of its text. 

The remote station sent a NAK when it was 
being selected or when sending ID sequences. 

The remote station contempuously violated 
the BSC protocol conventions. The driver is 
to disconnect the line, post the error, and 
process the next user request. 

A protocol error was received from the 
remote - send an EOT. 

The remote station rejected the local 
station's attempt to establish a connection. 
The driver is to disconnect the line, post 
the error, and process the next user 
request. 

The remote station responded with a NAK or 
EOT when the local station tried to bid for 
the line. The driver is to process the next 
user request. 

The remote sent TTD or WACK but it is not 
permitted in this context (see DOPTIONS 

An EOT was received from the remote 
station. The driver is to process the next 
user request. 

The current Intrinsic call has been aborted. 
The driver Is to process the next user 
request. 

The number of retries allowed has been 
performed. Return to the calling program 
without talcing any further action. 
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Table 6-i. Trace Entry ACTION Definitions CCont.) 



ACTION 



DEFINITION 



^(l^iijjj^ 



POST RVI RECEIVED 



POST SENT ACK, RECEIVED ACK 



POST SENT ACK, RECEIVED NAK 



POST SENT ACK, RECEIVED RVI 



POST SYSTEM ERROR 



POST WRITE BUFF SUCCESSFUL 



The remote station sent an RVI sequence 
("reverse interrupt" positive 
acknowledgement) in response to a text 
message. The driver is to process the next 
user request. 

The remote sent an ACK in response to our 
ACK. The driver is to process tne next user 
request. 

The remote sent an NAK in response to our 
ACK. The driver is to process the next user 
request. 

The remote sent an RVI in response to our 
ACK. The driver is to process tne next user 
request. 

While performing some function for the 
driver, MPE detected an internal error. The 
driver is to process the next user request. 



»r outpufLJ^ 



The current "Write buff" reques 
intrinsic call with no input oi 
buffer specified) was performed 
successfully. The driver is to process the 
next user request. 



POST WRITE REQ SUCCESSFUL 



READ CTRL SEQ,RE»RECV GARBGE 



READ BF: post READ SUCCESS 



The current CWRITE intrinsic call was 
performed successfully. The driver is to 
process the next user request. 

An unrecognizable control character sequence 
was received from the remote station. The 
driver is to retry the "read control" 
operation. 

The current "Read buf" request (CREAD 
intrinsic call with no buffer specified) was 
performed successfully. The driver is to 
process the next user request. 
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Table 6-3. Trace tntry ACTION Definitions (Cont.) 



ACTION 



DEFINITION 



HEAD TEXT, FEsRECV GARBAGE 



HEAD TEXT, RE=TEXT OVERFLOW 



RECEIVE REMOTE'S LINE BID 



During a "read text** operation, an 
unrecognizable text message was received 
from the remote station. The driver is to 
retry the "read text" operation. 

Either the remote sent a text block which 
was too large for our input buffer or the 
ETX/ETB character was garbled. The driver 
is to process the next request. 

The driver is to receive a line bid (ENQ) 
from the remote station. 



RECORD CONNECT TIMEOUT 



RECORD LATENT OLE EOT 



ZORD LATENT EQT 



RECORD LATENT RECV TIMEOUT 



The line was not physically connected within 
the allowed time. The driver is to post the 
error and process the next user request. 

A DLE EOT sequence was received from the 
remote station in response to a WACK or TTD. 
The driver is to disconnect the line, post 
the error, and await the next user request. 

An EOT was received from the remote station 
in response to a WACK or TTD. The driver is 
to post the error and await tne next user 
request. 

No response was received from the remote 
station to a WACK or TTD within the allowed 
time. The driver is to post the error and 
await the next user request. 



RECORD LOCAL T/0, DISCONNECT 



RECORD POWER FAIL, DISCNCT 



A CREAD or CWRITE intrinsic call was not 
issued within the maximum time allowed 
following a previous CREAD or CWRITE 
intrinsic call. The driver is to disconnect 
the line, post the error, and await the next 
user request. 

A power failure occurred. The driver is to 
disconnect the line, post the error, and 
await the next user request. 






6-49 



Table 6-3. Trace Entry ACTION Detinltions (Cont.) 



ACTION 



DEFINITION 



^L^jul^ 



RECORD RECV T/O, DISCONNECT 



RECRD OUT BFR DIRTY, SND EOT 



REMOTE REQUESTED DOWNLOAD 



REMOTE SENT DLE EOT 



Nothing (including TTD) was received from 
the remote station within the maximum time 
allowed during execution of a read 
operation. The driver is to disconnect the 
line, post the error, and await the next 
user request. 

During execution of a "Write Conversational" 
request, the remote station asiced the driver 
to resend its latest text message. However, 
the driver found that the text message in 
its buffer had been overlayed by a garbled 
response from the remote station. The 
driver is to send an EOT to the remote 
station. 

While executing a CREAD from unconnected or 
control state, the remote sent a NAK 
(instead of an ENQ) which requests the local 
user to send the download file. The driver 
is to process the next request, 

A DLE EOT sequence was received from the 
remote station. The driver is to disconnect 
the line, post the error, and process the 
next user request. 



\^, 



J 



REPEAT LAST PHYS DVR REQUEST 



REQ RESEND OF LAST ACK 



REQUEST RESEND OF TEXT 



The driver Is to repeat the latest physical 
driver request (i.e., the OPERATION 
specified in the previous OPR trace entry). 

The driver is to send an ENQ to the remote 
station. This asks the remote station to 
resend its latest acknowledgement* 

The text message received from the remote 
station (in conjunction with a "read text" 
or "write conversational" operation) was 
either garbled or contained parity errors 
and the local station is asking for it to be 
resent. 



o 
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Table b-3. Trace Entry ACriON Definitions (Cont.) 



ACTION 



DEFINITION 



RKSET TRIBUTARY 



RESPOND ENQ TO WACK 



The remote multipoint station must be put 
into control mode so that it will properly 
act upon the next select or poll request. 

A WACK sequence was received from the remote 
station. The driver is to respond by 
sending an ENQ. 



RESPOND NAK TO TTD 



SELECT TRIBUTARY 



SEND ACK, RECEIVE TEXT 



A TTD sequence has been received from the 
remote station. The driver is to respond by 
sending a NAK. 

Select the requested station so that the 
user's CWRITE request can be completed. 

The driver is to send either an ACKO or ACKl 
sequence (whichever is proper) to the remote 
station and then receive a text message. 



SEND DELAY SEQ, GET RESPONSE 



SEND DISCONNECT SEQUENCE 



Send either a WACK or a TTD depending on 
Whether reading or writing, respectively. 
Wait for a response from the remote. wACK is 
sent if the local is not ready to receive 
more data. TTD is sent if the local is not 
ready to transmit data. 

The driver is to send either a DLE EOT 

sequence (switched line) or an EOT to the 

remote station, disconnect the line, and 
then process the next user request. 



SEND ENQ, GET RESPONSE 



SEND ENQ, GET TEXT/RESPONSE 



The driver is to send an ENQ to the remote 
station and then receive a control character 
response. 

The driver is to send an ENQ to the remote 
station and then receive either a text 
message or a control character response. 



SEND EOT 



The driver is to send an EOT to the remote 
station and then process the next user 
request. 
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Table 6-3. Trace Entry ACTION Definitions (Cont.) 



ACTION 



DEFINITION 



\m^ 



SEND ID-ACK, RECEIVE TEXT 



SEND ID«ENO# RECEIVE ID-ACK 



SND MRJE DELAYVRECV TXT/BESP 



SEND NAK AND RECEIVE TEXT 
SEND RVI AND RECEIVE TEXT 

SEND TEXT AND RECV RESPONSE 

SEND TEXT, RECV TEXT/RESP 



SET STATION DOWN 



The driver is to send an ID ACKO sequence to 
the remote station and then receive a text 

message. 

The driver Is to send an ID ENQ sequence to 
the remote station and then receive an ID 
ACKO sequence. 



The driver is 
message, with the 
the Resp/Text Is 
further text will 
next Intrinsic c 
handshaking ACKO s 
clears this condlt 
TEXT FLAG action 
locally. This Is 
timeout occurs. 



to send a s 
MRJE waifa'bl 

received in 
be transmitted 
all (CREAD, 
end by the 
ion at the Hos 

clears this 
sent only when 



pedal text 

t set. After 

reply, no 

until the 

CWRITE). The 

CPEAD/CWRITE 

t. The CHECK 

condition 

an internal 



c 



Ask the remote to resend its text. 

The driver is to send an RVI sequence to the ^-. 
remote station and then receive a text* ^ 
message. 

The driver is to send a text message to the 
remote station and then receive a control 
character response. 

The driver is to send a text message to the 
remote station and then receive either a 
text message or a control character 
response. 

The station or group being addressed does 
not respond, or responds with unacceptable 
data. Note that this station or group Is 
"down** and refuse to reference It unless the 
station Is marked *'up** by the Intrlnslcs. 



o 
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Table 6-3. Trace Entry ACTION Definitions (Cont.) 



c 



ACTION 



DEFINITION 



SET TIMEOUT FOR NXT WACK/TTD 



TEST FOR TEXT RECEIVED 



TEST IF BLOCKING INPUT 



TEST IF IN DOWNLOAD MODE 



TFST IF LOCAL IS PRI OR SECN 



TEST IF OUTPUT BUFR IS DIRTY 



^^^ 



The driver is to reset the "WACK/TTD 
generator timer" to its starting value. 

Test the Text flag. This would have been set 
if text was received in response to the mrje 
DELAY action. 

An ETB was received at the end of this blocK 
of text - determine whether the user expects 
data to be blocked. 

While awaiting a line bid a nak has been 
received instead of the expected ENQ. If the 
driver has been configured for download then 
the NAK indicates that the remote is now 
ready to be downloaded. 

The driver is to test whether the local 
station is the primary or secondary station. 

During execution of a "Write Conversational" 
request, the remote station asked the driver 
to resend its latest text message. The 
driver is to examine the contents of its 
buffer to see if the text message got 
overlayed by a garbled response from the 
remote station. 



^•""^i*.^ 
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Table 6-3. Trace Entry ACTION Definitions (Cont.) 



ACTION 



DEFINITION 



\J 



TKST IF PROPER ACK RECEIVED 



TEST IF RSP T/0 JUST OCCURRD 



TEST IF SELECTION OR BRDCAST 



TEST IF SENT LAST BLOCK 



TEST IF STATION IS NEW 



TEST IF WILL WAIT FOR REMOTE 



TEST RECEIVED ID SEQUENCE 



TEST SOFT ABORT FLAG 



TEXT RECEIVED, NO REQUEST 



TRANSFER TEXT TO READ 



TRANSFER TEXT TO WRITE 



Tne driver Is to test the aCKO or ACKl 
sequence received from the remote station to 
make sure it is the one expected. 

The wrong ACK sequence was received from the 
remote in response to a text message. The 
driver is to test to see if a response 
timeout also occurred in conjunction with 
the "lost" text block. 

Check the intrinsic call to see whether the 
user wants to talk to an individual station 
or to the entire line. 

Determine whether any more data for the 
current CWRITE remains to be sent. 

A read or write is to be performed. 
Determine if the station referenced is the 
same as the previously referenced station. 

Determine if a delay request from the remote 
is allowed. £ 

Test to see if the ID sequence received is 
valid. 

Test to see if a soft abort has been 
requested by the intrlnsics. 

Text has been received in response to the 
MRJE DELAY action - the Text flag has been 
set. 

Text was received in response to a previous 
SEND MRJE DELAY action - transfer this text 
instead of reading from the line. 

Text was received in response to a previous 
SEND MRJE DELAY action - transfer this text 
instead of reading from the line for the 
write conversational. 
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Table 6-3, Trace Entry ACTION Definitions (Cont.) 



ACTION 



DEFINITION 



UNEXPECTED EVENT, DISCONNECT 



WAIT FOP LINE BID 



WAIT FOR PHYSICAL CONNECTION 



WAIT FOR RESEND OF RESPONSE 



WRITE CONVR: TEXT ERROR 



WRTE CONV; POST READ SUCCSFL 



Somethinq unexpected happened. The driver 
is to post the error and then await the next 
user request. If the communications linic 
with the remote station currently exists, 
the driver will first send a DLE EOT 
sequence (switched line) or an EOT 
(non-switched line) to the remote station 
and disconnect the line. 

The current intrinsic call is either "Read 
Connect" or "Read Connect, Enquiry" (CREAD 
with OPCODEsO or 2) and the driver is 
waiting for the communications link to be 
established and a line bid (ENQ) to be 
received from the remote station. 

The driver is waiting for the communications 
linK to be established. 

The control character response from the 
remote station (in conjunction with a "write 
text" operation) was either garbled or lost 
and the local station has asked for it to be 
resent. The local station is currently 
waiting for the retransmission of the 
control Character response. 

Text containing parity errors was received 
from the remote station as the response to a 
text message during execution of a "Write 
Conversational" request (CWRITE with o^tput 
and input buffer specified). The driver has 
asked the remote station to resend its 
response. 

The current "Write Conversational" request 
(CWRITE with, output and Input buffer 
specified) was performed successfully. 
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CONFIGURING CS/3000 I Section VII I 

t i 



7.1 Configurator Dialog 

a' number of extensions have been made to the MPE configurator to 

accommodate CS. These extensions, concerned exclusively with I/O 

configuration changes, are necessary to add CS to a system or to 
alter an existing CS configuration. 

The extensions are of one of two forms: 1) modified control paths 
through the dialog steps resulting from responses to existing (i.e., 
file-system related) questions, and 2) new dialog steps pertaining 
to CS, Both forms are described in the dialog changes given below. 
Two step numbers are given for each interrogation. The first refers 
to :SYSOUMP command dialog steps and the second (parenthesized) 
refers to the initiator dialog steps; both of which are taken from 
the MPE Version C ERS. Where existing dialog steps are discussed, 
only changes and extensions are described. 

3.1(8) LIST 1/0 DEVICES? 

If YES is entered, a list of all input/output devices will 
be printed. This list will include CS devices. For CS 
devices, only that information common to CS and FS will be 
printed. 

If CS is known to exist on the system, the next step will 
be 3,1,1(8.1). Otherwise, the next step will be 3.2(9). 

3. 1. 1(8. DLIST CS DEVICES? 

To print a list of CS device characteristics, enter YES. 
TO suppress the listing, enter NO. 
The next step will be 3.2(9). 
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3.3(10) LOGICAL DEVICK #? 



If a zero or carriage return is entered, the dialog will ^m^ 
sxip either to 3.3.13(22.1) if CS exists or has been added f 1 
to the system or 3.4(23) otherwise. ^**^ 

3.3.1(U) DRT #? 

To add a device, enter its DRT number. To remove a device 
and return to step 3.3(10), enter zero. 

3.3.2(12) UNIT #? 

Enter a zero for CS device types 17, 18, or 19. 
3.3.2A CHANNEL #? 

Enter a zero for CS device types 17, 18, or 19. 
3.3.3(13) TYPE? 

The following device types have been allocated to CSi 

17 - Single Channel Communications Processor (SCCP) 

18 - Synchronous single Line Controller (SSLC) 

19 - High speed Serial Interface (HSI) 

3.3.4(14) SUB-TYPE? 



If TYPE is 19, then SUB-TYPE must be 

If TYPE is 17 or 18, then the following SUB-TYPE values 
are defined: 

- Synchronous/Switched/Modem 

1 - Synchronous/Non-switched/Modem 
3 - Synchronous/Non-switched 

7 - Asynchronous/Non-switched 

If TYPE and SUB-TYPE indicate this is not a CS device, the 
next step will be 3.3.4.0(15). If TYPE=19, the next step 
will be 3.3.4.0(14.0). If TYPE=17 or 18, the next step 
will be 3.3.4.1(14.1). 
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3. 3. 4. 0(14,0) PORT MASK? 



c 



This value will form a mask indicating which HSI channel 
will be used by this line. Permissable values are 

8 - HSI channel 

4 - HSI channel I 

2 - HSI channel 2 

1 - HSI channel 3. 



3.3.4.J(14.1) PROTOCOL? 



The protocol number tor 
Allowable values are 1-255 
values are 

1 = Bisync 

2 = MRJK 

3 = HPDLC I 



the device should be entered, 
currently the only defined 



3.3.4.2(14.2) LOCAL MODE? 






The local mode for the station should be entered. 
Allowable values are 1-15. Currently defined values are: 

1 = local is primary contention station 

2 = local is secondary contention station 

3 s local is multipoint control station. 

4 s local is secondary station on a multipoint line 

5 = local is an HPDLC I system acting as DTE 

6 = local is an HPDLC I system acting as DCE 

The next step is 3.3.4.3(14.3). 



3.3.4.3(14.3) TRANSMISSION CODE? 



The transmission code for the device should be entered. 
Allowable values are 1-63? the currently defined values 
are 



1 - 



automatic code sensing if the connection is 

accomplished by a CREAD, ASCII if the connection 

is done with a CWRITE. 

ASCII 

EBCDIC 
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3,3,4,4(14.4) RECEIVE TIMEOUT? 



The receive timeout value should be entered. This is the 
length of time that the local station will wait for a text 
block to be sent by the remote. If a carriage return is 
entered, a 20-second default will be provided. 



3.3.4.5(14.5) LOCAL TIMEOUT? 



The local timeout value should be entered. This is the 
amount of time that CS will allow between the completion 
of the previous I/O request and the initiation of the next 
one. Note that this only applies when the line is 
connected. If a carriage return is entered, a 60-second 
default will be provided. The next step is 3.3.4.7(14.7), 



3.3,4.7(14.7) CONNECT TIMEOUT? 



The connect timeout value should be entered. If a carriage 
return is entered, a 900-second default will be provided. 

For non-switched lines, if SUB-TYPE implies connection via 
a modem, the next dialog step will be 3.3.4.11(14.11). If 
SUB-TYPE implies a hardwire connection the next dialog 
step will be 3.3.4.13(14.13). If SUB-TYPE implies a 
switched line, the dialog will proceed in sequence. 



3.3.4,8(14.8) DIAL FACILITY? 



A YES response will indicate that the line has the ability 
to dial out (either manually or automatically). 



3.3,4.9(14.9) ANSWER FACILITY? 



To specify that this device has an answering capability 
enter YES. If the response is NO, the dialog will skip to 



step 3.3.4.11(14,11). 
4.9.1(14.9.1) AUTOMATIC ANSWER? 



To specify that this device has automatic answer 
capabilities enter YES. A NO response will indicate 
manual answering is required. 
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3.3,4.11(l4,ll) DUAL SPEED? 



c 



To specify that the modem is dual speed, enter YES, If 
the response is NO, the dialog will sKip to step 
3.3.4.13(14,13). 



3.3.4.12(14.12) HALF SPEED? 

If the modem is to operate at half '-speed enter YES. To 
specify that the modem is to operate at full speed enter 
NO or a carriage return. The next dialog step will be 
3.3.4.14(14.14). 

3.3.4.13(14.13) SPEED CHANGEABLE? 

If the speed of the line is changeable, enter YES. 

3.3.4.14(14,14) TRANSMISSION SPEED? 



Enter the transmission speed of the line in characters per 
second. 



i. 3. 4. 15(14, 15) TRANSMISSION MODE? 



One of the following transmission modes should be entered: 

= full duplex 

1 s halt duplex 

2 = simplex - write only 

3 = simplex - read only. 

The HSI hardware requires full duplex. When using the 
Bisync protocol, the SSLC interface may require either 
half or full duplex, depending on the type of line and 
modems. 



3.3.4.16(14.16) PREFERRED BUFFER SIZE? 



^*%. 

^^y^ 



Enter the buffer size (in words) most suitable to the 
device being configured. When using the HSI or SSLC 
boards, this value must be less than or equal to 4095. 
This value becomes the default COPEN 6UFFSIZE. 
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3.i.4.17(i4.17) DRIVER CHANGEABLE? 

It a user program can change the driver for this device, ^^ 
enter YES, ^J 

3.3.4.18(14.18) DRIVER OPTIONS? 

« «lf Wi «■*■•»<■ w <.• Ml ^ «• an ■• 

Enter the appropriate driver options value for the default 
driver. The next dialog step will be 3.3.11(21). 

3.3.11(21) DRIVER NAME? 



Enter the name of the default driver for this line. 
It the device is not a CS device (i.e., TYPE <> 18-xx), 
the dialog will skip to step 3,3.12(22). Otherwise, if 
SUB-TYPE implies a non-switched line then: 

a. if the line is point to point the dialogue will 
return to step 3.3.11.4(21.4). 

b. if the line is multipoint the dialog will skip to 
3.3.11.6(21.6). If the line is switched, the dialog 
will proceed with step 3.3.11.2(21.2). 



3.3.11.2(21.2) PHONELIST? 



To provide a default phone number list, enter YES. If the 
response is NO, the dialog will skip to step 



o 



3.3.11.4(21.4) 
3.3.11.3(21.3) PHONE NUMBER? 



A phonenumber can be specified by entering a string 
composed of numeric characters and hyphens. The total 
string length must not exceed 20 characters. This dialog 
step will be repeated until a carriage return is entered. 



3.3.11.4(21.4) liOCAL ID SEQUENCE? 



The local ID seguence can be specified in one of the 
following two forms: 

I. A 

"string'* 
E 
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2, 

(d,Ud]...) 
H 

These are tne same sequence specifications as those 
described for those of the ;CLINE command (Section III). A 
maximum of 16 bytes is allowed. 

If a carriage return is entered, a null local ID sequence 
will be assumed. 



3.3.11.5(21.5) REMOTE ID SEQUENCE? 



A remote ID sequence is specified in the same format as 
the local ID sequence. 

This dialog step will be repeated until a carriage return 
is entered, if Local mode indicates a control station in 
supervised mode then the next dialogue step will be 
3.3,11.6 (21.6), Otherwise the dialog returns to step 
3.3(10). 



3,3.11.6(21.6) POLL ENTRY DELAY? 



Enter the number of milliseconds between polling each 
entry in the POLLIST, If a carriage return is entered, a 
200 millisecond default will be provided. 



3.3,11.7(21.7) NUMBER OF POLL REPEATS? 



Enter the number of times the poll list is to be scanned 
per I/O operation. If this number is zero the poll list 
will be repeated until a terminal responds af f irinitively. 
If a carriage return is entered, a value of zero will be 
used. 



3.3.11,8(21,8) CIRCULAR POLL DELAY? 



Enter the length of time, in hundredths of seconds, 
between successive passes through the poll list. If a 
carriage return is entered, a value of zero will be used. 



^*\ 

\^*"' 
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J.3,1U9(21,9} MULTIPOINT LINE TYPE? 

*>«>«•«• W ^ «■«■«■«»«« a> an ar «p w ot ■» at «p «, 

This is reserved for future use - enter a carriage return 
.3.11.ll(21,ll) ID VEHIFICATION? 



If no ID verification is to be performed then enter NO or 
carriage return. Otherwise type SEND if the local station 
is to initiate sending of IDs or RECV if the remote staton 
is to wait for the remote to initiate ID sending. 



3.11.12(21.12) LINE SELECTION SEQUENCE? 



The line selection sequence is specified in the same 
format as the local ID sequence. A maximum of 8 bytes is 
allowed. If the line does not support this facility, a 
carriage return should be entered. 



3.11.13(21.13) NUMBER OF GROUPS? 



3.11.14(21.14) GROUP g POLLING ID? 



The polling ID is specified in the same format as the line 
selection sequence. A maximum of 8 bytes is allowed. Jf 
the group has no polling ID then a carriage return should 



be entered. 
3.11.15(21.15) GROUP g SELECTION ID? 



The selection ID is specified in the same format as the 
line selection sequence. A maximum of 8 bytes is allowed. 
If the group has no selection ID then a carriage return 
should be entered. 



o 



Enter the total number of terminal groups attached to the 
line. The permissable range is from 1 to 254. This 
number will determine the number of times the dialog step 
sequence 3.3.11.14 - 3.3.11.24 will be repeated. Following \J 
this the dialog returns to step 3.3(10). 



7-8 



3»3.1U16(21.16) GROUP g GENERAL POLL ID? 



c 



The general poll ID Is specified In the same format as the 
line selection sequence. Note that this is appended to 
the group polling ID to form the general poll sequence. 
The maximum length of the concatenated sequence is 8 
bytes. If the group does not support this facility, then a 
carriage return should be entered. 

3.3.11.17(21.17) GROUP g GENERAL SELECTION SEQUENCE? 

The general selection ID is specified in the same format 
as the line selection sequence. Note that this is 
appended to the group selection ID to form the general 
selection sequence. The maximum length of the 
concatenated sequence is 8 bytes. If the group does not 
support this facility, then a carriage return should be 
entered. 

3.3.11.19(21.19) NUMBER OF STATIONS IN GROUP g? 

Enter the total number of stations (terminals) attached to 
the group. This number will determine the number of times 
the dialog step sequence 3.3.11.22 - 3.3.11.24 will be 
repeated. The maximum number of statons permitted on the 
line is 254. 

3.3.11.20(21.20) STATION TYPE? 



The allowable values are; 

s Hp 2645 

1 -40 s Reserved for future use 
41-63 = user defined station type. 



3.3.11.21(21.21) STATON INPUT BLOCKSIZE? 



If the value is different from the line's PREFERED BUFFER 
SIZE, then enter the proper value. Otherwise enter a 
carriage return. 

3.3.11.22(21.^2) NUMBER OF COMPONENTS ON STATION s? 

Enter the total number of components attached to the 
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station. This number will determine the number of times 
the dialog step sequence 3. 3. 11,23 - 3,3,11,24 will be 
repeated. The permissable number of components is from 
one to sixteen. 



,3,11.23(21,23) COMPONENT C POLL ID? 



The polling ID is specified in the same format as the line 
selection format. Note that this ID is appended to the 
group polling ID to form the component's polling sequence. 
The maximum length of the concatenated sequence is 8 
bytes. If this component does not support polling then a 
carriage return should be entered. 



3,11.24(21.24) COMPONENT c SELECTION ID? 



The selection ID is specified in the same format as the 
line selection format. Note that this ID is appended to 
the group selection ID to form the component's selection 
sequence. The maximum length of the concatenated sequence 
is 8 bytes. If this component does not support selection 
then a carriage return should be entered. 



3.3,12(22)CLASS NAME? 



Enter a list containing at least one device class name (up 

to eight alphanumeric characters, beginning with a 

letter). Class names are separated from each other by 
commas . 



3.4(23) LIST I/O DEVICES? 



If CS is not present in the system, then the dialog will 
skip to step 3.5(23.1). 



.4.1(23.0.1) LIST CS DEVICES? 



To print a list of CS device characteristics, enter YES. 
To suppress the listing, enter NO. 

If CS is not present on the system, then the dialog will 
sicip to step 4(24). 
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3.6(23.8) ADDITIONAL CS DRIVfclR CHANGES? 

Enter YES to add or delete drivers from the list of CS 
drivers which may be used but may not be attached to 
particular devices. Enter NO to sicip these changes and 
proceed to step 4(24). 

3,6.1(23,8.1) LIST ADDITIONAL DRIVERS? 

Enter YES to list the additional driver names. 

3.6.2(23.8.2) DELETE DRIVER? 

To delete one or more drivers, enter a YES. Otherwise 
enter NO to skip to step 3.6.4(23.8.4). 

3.6.3(23.8.3) DRIVER NAME? 

Enter the name of the driver to be deleted. This question 
is repeated until a carriage return is entered, 

3.6.4(23.8.4) ADD DRIVER? 

To add one or more drivers, enter a YES. Otherwise enter 
NO to skip to step 3.6.6(23.8,6). 

3.6.5(23.8.5) DRIVER NAHE? 

Enter the name of the program file containing the 
alternate driver. This question is repeated until a 
carriage return is entered, 

3.6.6(23.8,6) LIST ADDITIONAL DRIVERS? 

Enter YES to list the additional driver names. 
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C5/3000 LOGGING FACILITY 1 Section VIII 1 

I 1 



CS Log Records 

There are three different types of CS log records: 

1) Line disconnection record (type 9) 

2) Line close record (type 10) 

3) Line errors detected by the driver (type 11) 

Each of these record types may be selected/suppressed at system 
configuration time. 
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.1 Line Disconnection Record 



This record type provides accounting information for the duration of 
the connection. 



o 



Record formats 



word 


number of 


displacement 


words 





1 


1 


1 


2 


3 


5 


1 


6 


1 


7 


2 




2 


11 


2 


li 


1 



14 

15 
24 
33 



1 

9 

9 

10 



contents 



record type = 9 

record length s 43 

time stamp of disconnect or close 

job type, job number 

logical device number 

duration of the connection in milliseconds 

number of output data transfers 

number of input data transfers 

number of recoverable line errors 

modulo 2**16 

number of irrecoverable line errors 

modulo 2**16 

local ID sequence 

remote ID sequence 

phone number of remote 



NOTES: n time stamps are in CHRONOS/CLOCK format 

2) ID sequences are significant for both Sw and nsvt lines. The 
first byte is the length of the sequence. The remainder is 
the actual ID sequence (up to 16 bytes, left-justified). 

3) The phone number is significant only if the local 3000 
performed the dialing for an outgoing call. The phone 
number is represented in ASCII (up to 20 characters, 
left-justified with trailing blanks), 

4) CCLOSE of a connected line will emit one line disconnect log 
record followed by one line close log record. 



o 
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8.2 Line Close Record 

r This record type provides accounting information about the allocation 
L of a line (logical device). 

Record format: 



Contents 



record type =10 
record length = 14 
time stamp of close 
job type, job number 
logical device number 
time stamp of open 
driver name 

NOTES? 1) time stamps are in CHRONOS/CLOCK format. 

2) the driver name may be up to eight ASCII characters in 
length, left-justified with trailing blanKs. 



"^ 



word 


number of 


displacement 


words 







I 




2 




5 




6 




7 




10 


4 
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8.3 cs I/O Errors 



This record type provides information about instances ot the following 
types ot CS line errors: 

1) Any hardware error (CCHECK error code values ot 101-149) 

2) retry count exhausted due to any of the following recoverable 
errors: 

CCHECK 
Recoverable 
Error code Description 

2 received unintelligible sequence 

3 block check character error 

5 received incorrect acknowledgement 

8 received unintelligible sequence after sending 

text 

9 received enquiry character after sending text 
11 remote requested resend of last text block 

13 received text overflow 

14 data overrun occurred on the SIO multiplexor 

Channel 

15 transfer error occurred on the SIO multiplexor 

channel 

The record type and format is the same as an I/O Error (type=ll). 
Please refer to the System Supervisor Capabilities Manual for the 
record's format. Within the format, the following data items have 
special meaning: 

I/O Record Interpretation for 

Format Name CS device 



HARDWARE STATUS Same as ERRORCODE parameter ot CCHECK 

intrinsic 

DRIVER DEFINED Current number of recoverable errors 
PARAMETER #1 during this connection 

DRIVER DEFINED Number Of retries while executing the 
PARAMETER #2 current I/O request 
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CS/3000 OPERATOR MESSAGES 
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section IX 
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9.1 Dial Message 

This message Informs the operator that a manual dialing operation is 
required in order to physically connect a switched line. A reply to the 
message is required to inform the appropriate CS intrinsic if the phone 
number specified was successfully dialed. The message has a format 
number of 2; the <message> portion is 

LDEVt Idn DIAL phonenumber. ANSWERCY/N)? 

where Idn = logical device number of the CS line 

If the number is successfully dialed then a "Y" should be 
typed, else type "N". 

V.2 Error Message 



This message informs the operator when an irrecoverable error occurs on 
a line; no reply is required. 

LDEV# Idn CS I/O ERROR! errorcode 

where Idn = logical device number of the CS line 
errorcode « is a CCHECK hardware error number. 

This error message may be suppressed by setting AOPTIONS. (11 ;1 ) to "I" 
in the COPEN parameters. 



9.3 System Failures 



^^\ 
^^' 



The following System Failures are generated by CS: 

900 I/O request no longer associated with the user's process 

902 Unable to freeze segment in main memory 

903 Unable to locic segment in main memory 
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904 Unable to increase data segment size 

905 Unable to decrease data segment size 

906 Unable to unfreeze segment in main memory 

907 Unable to unlocJc segment in main memory 
909 Invalid pointer to pollist area 



>.4 SCCP RAM Dumps 



o 



wfhen an SCCP system failure is detected, CS attempts to dump tne 
contents of the SCCP RAM to a disc file by issuing a CCONTROL call with 
the controlcode =53 and a parameter value of (zero). Upon initiating 
the SCCP RAM dump, the following message is printed on the operator 
consoles 

SCCP RAM DUMP - LDEVnnn 

where nnn is the logical device number for the SCCP, 
If the dump is successfully completed, the message 

SCCP RAM DUMP COMPLETED ♦♦♦♦ 

will appear, A dump file may have the information from the SCCP RAM even 
though the entire dump operation was not successfully completed. 

More information concerning the SCCP RAM dump facility is included in 

the description of CCONTROL 53. ^-^ 

o 



o 
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10. 1 CS/3000 SHOWCOM Command 

CS/3000 provides for the monitoring ot communication system device 
status via the SHOWCOM operator's console command. The status 
information can be used to determine communications line activity and 
quality. 

Communications device status provided via the SHOWCOM command 
includes: 

- Number of messages sent and received. 

- Last recoverable and irrecoverable errors. 

- Number of recoverable and irrecoverable errors. 

- Number of retransmissions, response timeouts, 
clear to send losses, and underruns. 

- Number of BCC/CRC errors, receive timeouts, 
carrier losses, and overruns. 

p\ - Line stateCclosed, connected, or disconnected). 

note: Clear to send losses and carrier losses will 

only be valid for comunication lines configured 

as full duplex. 

Underruns will occur only when the communication 

line uses the HPDLC protocol. 

Receive timeouts will not occur on communication 

lines using the HPDLC protocol. 

When the line is in the open state, either connected or disconnected, 
the status SHOWCOM reports is a snapshot of the statistics generated 
from the last open of the line to the point in time the SHOWCQM 
command is invoiced. When the line state is closed, SHOWCOM reports 
status obtained at the closure of the line reflecting the statistics 
generated over the last open/close sequence. 



^"*\ 
^»^' 
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10.2 SHOWCOM Command Syntax 

The tormat of the SHOWCOM operator's console command is 
sSHOWCOM ldnC;ERR0RS3 t;HESET] 

PARAMETERS DESCRIPTION 

Idn Logical device number of a communications system 
device. 

ERRORS A request for the full status list, if not 

specified an abbreviated list is reported(see 10.3). 

RESET A request to reset all status information to 
zero after reporting. 



o 
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10.3 SHOWCUM Command Output 



SHOi«!COM produces the tollowinq report If the ERRORS parameter Is not 
specifed. 



LDN - XXX 
MESSAGES SENT XXXXX MESSAGES RECEIVED 
LAST RECOVERABLE ERROR XXX 
LAST IRRECOVERABLE ERROR XXX 
LINE IS LLLLLLLLLL 



XXXXX 



When the ERRORS parameter Is specified, SHOWCOM provides the follo*?ing 
report. 



TRANSMIT 
MESSAGES SENT 
RETRANSMISSIONS 
RESPONSE TIMEOUTS 
UNDERRUNS 

CLR TO SEND LOSSES 
« OF 
LAST 
# OF 
LAST 
LINK 



XXX 



LDN - 

XXXXX 

XXXXX 

XXXXX 

XXXXX 

XXXXX 
RECOVERABLE 
RECOVERABLE 
IRRECOVERABLE 
IRRECOVERABLE 



RECEIVE 
MESSAGES RECEIVED 
BCC/CHC ERRORS 
RECEIVE TIMEOUTS 
OVERRUNS 
CARRIER LOSSES 



ERRORS 

ERROR 
ERRORS 
ERROR 



XXX 
XXX 
XXX 
XXX 



IS LLLLLLLLLL 



XXXXX 
XXXXX 
XXXXX 
XXXXX 
XXXXX 



In the above examples, XXXXX indicates a positive integer, and 

LLLLLLLLL specifies either the closed, connected, or disconnected line 

state. The last irrecoverable and recoverable error codes are 
specified in sections 4.12 and 4,13. 



SHOWCOM command syntax errors or parameter errors will produce one 
the following error messages. 



of 



- TOO MANY PARAMETERS 

- LDN MISSING 

- ILLEGAL LDN 

- NOT A CS DEVICE 

- INVALID DELIMITER 

- ILLEGAL OPTION 

« CS I/O ERROR XXX 



the Idn specified is > 255, 

the Idn specified does not represent a 

communications system device, 

a parameter other than ERRORS or RESET 
was specified, 

in processing the SHOWCOM request, I/O 
error XXX was encountered. 
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CREAD 

The"executlon of a CREAD will differ substantially depending upon protocol 
driver, line mode and line state, 

A.l CONTENTION DRIVER, 

Unconnected line state 

Line States unconnected --«-".-•---> text 

Functloni a. establish physical connection 

b. receive the remote's line bid (optionally with ID 
verification) 

c. send an acknowledgement to the remote's line bid 
(optionally with an ID) 

d. receive the remote's first text block 

Notes If INCOUNT is omitted or set to zero, then only steps a and b are 
executed. If there is a local ID sequence then it will be sent on 
the next CREAD request. The next I/O request should be a CREAD. 

Control line state 

Line state: control-------- — > text 

Functions a, receive the remote's line bid 

b. acknowledge the remote's line bid 

c. read the remote's text block 

1. If INCOUNT is omitted or set to zero, then only step a is 
executed. The next I/O request should be a CREAD. 

2, While the line Is in control state the CS driver listens for a 
line bid from the remote. If the line bid occurrs then the line 
is automatically placed into text state. If bit 3 of the ^OPTIONS 
is set to a one, then the driver will Ignore remote line bids 
between requests. 



Note 
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Text line state 

Line state: text----— -— -> text 

Functions a, acknowledge last text block 

b. read the remote's next text block 

A. 2 MULTIPOINT CONTROL DRIVER. 

Unconnected line state 



o 



Line state: unconnected —-•••----> text 

or 
unconnected -••--••---> control 

Function: a» Establish physical connection. 

b. Optionally perform ID verification as specified by the 
Line Descriptor in SUPLIST. 

c. If the STATION parameter specified a station then: 
1) poll that station 

2} if the station responds negatively then post the 
request finished (line state « Control) 

3) else receive the text from the remote (line state « 
Text) 

d. Else if the STATION parameter specifies the POLLIST 
then starting with the current entry in the POLLIST: 

1) poll the station (or group) 

2) if the station responds affirmatively then 
receive its text (line state = Text) 

3) else if this is the last entry in the POLLIST and 
the required number of passes through the list have 
been done, then post the request done (line state s 
Control). 

Else index to the next entry in the list and go 
back to step 1. 

NOTE: If data can be received in blocks, then several blocks of 
data may be received with an acknowledgement to each 
block. Conceptually, however, a buffer of data is received 
as described above. 

Control line state 



Line state: control ------•—-> text 

or 
control ——--•---> control 

Function: Same as steps c - d of the unconnected line state. 
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Text line state 

jie state: text --•-------> text 

or 
text ••-----«••> control 

Function: a. If the STATION parameter specifies the current station 

then: 

1) send an acknowledgement of the remote's last text 
block 

2) receive the next text block from the station (line 
statesText) 

b. Else if the STATION parameter specifies another station 
then: 

1) if D0PTI0NS,(2;1) specifies that the previous 
station must be reset by sending it an RVI, then 
send an 8VI sequence and receive an e:0T sequence, 
(see COPKN for description of PORTIONS) 

2) poll the station 

3) receive either a negative response to the poll (line 
state=Control) or the remote's text block (line 
state=Text) 

c. Else if the STATION parameter specifies the POLLIST 
then: 

1) if current POLLIST entry is a logical station 
entry 

(a) if DOPTlONS.(2:n specifies that the previous 
station must be reset by sending it an RVI, 
then send an RVI sequence and receive an 
EOT sequence. (See COPEN for description of 
DOPTIONS) 

(b) starting with the next entry in the POLLIST: 

(1) poll the station (or group) 

(2) if the station responds affirmatively 
then receive its text (state=Text) 

(3) If this is the last entry in the POLLIST and 
the required number of passes through the 
list have been done, then post the request 
done (state = Control). 

Else index to the next entry in the list 
and go back to step (1). 

2) current POLLIST entry is a logical group entry 

(a) acknowledge the previous text block and 
attempt to read the next text block 
from the current group. 

(b) if an EOT is received instead of text, 
then poll as in case c.l.c of the above. 

Note: If the STATION parameter is specified, then with one exception the 
pollist index remains unchanged: 
i) text state has been previously entered through a CREAD specifying 

the POLLIST, 
2) the STATION parameter specifies the current station. 
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3) and the remote terminal responds with an EOT instead of an 
acknowledgement or text. 

o 

A. 3 MRJE DRIVER* 

Unconnected line state (not currently used by MRJE) 

Line state: unconnected —•——----> text 

Functions a* Establish physical connection 

b. Receive line bid 

(receive SOH,EN0; send ACKO) 

c. While waiting for the text block, answer 
remote's ACKO's with ACKO's 

d. Read the remote's text block 

Control line state (not defined for MRJE) 



Text line state 



Line states text--— —•---> text 

Functions a. acknowledge last text block with ACKO ■ J 

b. While waiting for next text block, answer remote's ACKOs ^" 
with ACKOs 

c. read the remote's next text block 



u 
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A. 4 SCCP and SSLC BSC Driver Message Format word (MFV«) 



c 



All BSC control characters are deleted Irom the incoming text stream by 
the driver. 

If D0PTI0NS,(11 :2) is set to two then The driver describes the received 
text's format via the message format word (MFW) which is contained in 
word of the user's buffer. Any other value of DOPTIONS, (11 :2) will 
cause the MFW to be omitted from the user's text and, hence, 
unavailable to the user. The MFW fields have the same meaning as in 
sent text. 

MFW (0:1) -- Os the received text was transparent. If the text 

contained iTBs then this bit means that at least one 
intermediate text block was transparent. 
Is the received text was non-transparent. 

MFW (1:1) -- 0= the received text contained no intermediate 

text blocJcs (itb's), 

1= there were itb(s). The length of each itb immediately 
precedes its block. The length is a 16-bit quantity 
and always begins on a word boundary. The last itb is 
followed by a delimiter word set to all ones. 

MFW (2:1) — Note: This field is significant only when there were 

itb's in non-transparent text. 

Os not all itb's began with an SOH or STX character. 
Is each itb was begun with an SOH or STX character. 

MFW (3:1) — OS the text block ended with an ETX character. 
Is the text block ended with an ETB character. 

NOTE: Regardless of whether a text block ends in ETB or 
ETX, its successful transmission or reception 
will increment its respective "message" counter 
(i.e. MSGSENT/MSGRECV in the CCHECK Intrinsic). 

MFW (4:4) -- set to zero. 

MFW (8:8) -- Length of the header portion of the text block. A 

value of zero indicates that there was no header. 
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Nontransparent block, -.••-•.•»•<»•.•«•.•..• 
not the last blocK of STX data ETB 

text* •••••••••.•••••«•••• 

Nontransparent block, —«—.•——••• — •.« 
the last or only STX data ETX 

block of text« ....•.••••«•......•• 

Transparent block not •..••.•.•.•..•^•••••. ••••.. 

the last block of DLE STX data ETB 

text. •*•••«••••«.••••.••«,••.•.••. 

Transparent block, the ---•.-—-•—•«.-•.•-••• 
last or only block of dle STX data ETX 

text. •«••••«.•.•••••••.••«.•• 

A nontransparent block, ••••.....•.•.••.•••...•.•••„....• 
the last or only block SOH heading STX data ETX 

of text, with a heading. •———••.•—.••........•...•• 

A transparent block, -••—.—--.•—-——.——.•.—.•,.,-.. 

the last or only block sOH heading DLE STX data eTX 

of text, with a heading. -—--—-— ——-.--— —.—--.— ..•...•.. 

A heading all by itself. •———.—-..—--. 

SOH heading ETB 

A nontransparent block —.——.—-..•—..•. ^ . 

to be ignored/aborted. STX data ENQ i v 

A transparent block to ----«>->••..«••••..••.••••.•.•••...•• 
be ignored/aborted. DLE STX data DLE ENQ 



Figure A-l 
Construction of Data Blocks Using Control Characters 



o 
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CWRITE 



C 



execution of a CWRITE will vary substantially depending on protocol 
fiver, line state, and on which parameters are specified. 



A. 5 CONTENTION DRIVER. 

Unconnected line state 

Line state: unconnected -----•--> text 

Function: a, establish physical connection 

b. bid for the line (optionally with I/O verification) 

c. send contents of output buffer 

d. receive either an acknowledgement of the sent 
text block or a text block from the remote. 

Note: 1. If the input buffer is omitted then only an 
acknowledgement is expected from the remote 
in step d. 
2. If both the input and output buffers are not 
specified then only steps a and b will be 
performed. 

control line state 



Line state: control --> text 

Function: a. bid for the line 

b. send contents of output buffer 

c. receive either an acknowledgement of the sent 
text block or a text block from the remote. 

Note: 1. If the input buffer is omitted then only an 
acknowledgement is expected from the remote 
in step c. 

2. If both the input and output buffers are not 
specified then only step a is executed. 

3. While the line is in control state the CS driver listens 
for a line bid from the remote. If the line bid occurrs 
then the line is automatically placed into text state. 
If bit 3 of the DOPTIONS is set to a one, then the 
driver will ignore remote line bids between requests. 
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Text line state 

Line state: text -•—-•--> text 

Function: a. send contents of output buffer 

b. receive either an aclcnolwedgeroent of the 
sent text block or a text block from the 
remote. 

Note: If the Input buffer is omitted then only an acknowledgement is 
expected from the remote, 

6 MULTIPOINT CONTROL DRIVER. 

NOTE: If the text is to be sent in blocks, each block is acknowledged 
by the receiving station. Conceptually, however, the 
transmission of the entire buffer of data may be described as 
follows below. 

Unconnected line state 



Line state: unconnected -••--.-••-> text 

or 
unconnected -••-«-•-«.-> control 

Function: a. Establish physical connection, 

b. Optionally perform ID verification as specified by the 
Line Descriptor in SUPLIST, 

c. If the STATION parameter specified only one station 
then: 

1) select that station and receive acknowledgement 

2) send the contents of the output buffer 

3) receive an acknowledgement of the sent text 

4) final line state s Text 

d. Else if the STATION parameter specifies general select 
or line select then send the contents of the output 
buffer. The final line state is Control, 

Control line state 

«• w w «•>«■«»«> <a> a» a* aK ««■«» «B « w <» 

Line state: control -—------•> text 

or 
control — — > control 

Function: same as steps c - d of the unconnected line state. 



o 



o 
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Text line state 

Line state: text ---.-> text 

or 
text ------•---> control 

Function: a. If the STATION parameter specifies the current station 
and the previous operation was also a write then: 

1) send the contents of the output buffer to the station 

2) receive an acknowledgement of the sent text block 

3) final line state = Text 

b. Else if the STATION parameter specifies another station 
and the previous operation was also a write then: 

1) select the station (Includes sending an EOT sequence) 

2) send the contents of the output buffer 

3) receive an acknowledgement of the sent text block 
5) final line state = Text 

c. Else if the STATION parameter specifies a station 
and the previous operation was a read and 
D0PTI0NS.(2:n specifies that an PVl should be 
issued before changing stations, then: 

1) send an RVI and receive an EOT response 

2) perform the steps outlined in "b." above 

c. Else if the STATION parameter specifies general or line 
select then: 

1) send an fc:OT sequence 

2) send the group or line select sequence followed by 
the contents of the output buffer 

3) final line state = Control 

Note: With this one exception the poUist index remains "'^^^^ff^^^^ Vu;r„n 

1) text state has been previously entered through a cread 
specifying the POLLIST, 

2) the STATION parameter specifies the current station, 

3) and the remote terminal responds with an EOT instead of an 
acknowledgement or text. 



A, 7 MRJE DRIVER 

Unconnected line state: 









Line state: unconnected • — -•---> text 

Function: a. establish phsyical connection 

b. bid for the line using MRJE line bid (send SOH EnQ, 
receive ACKO) 

c. send contents of output buffer 

d. receive either an acknowledgement of the sent text block 
(always ACKO) or a block from the remote. 
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Note: CWRITE defined only for MRJE when specifying both input and 
output buffers. 

Control line state: (not defined for MRJE) \J 



Text line state: 



Line state: text •«•-—--> text 

Function: a. send contents of output buffer 

b. receive either an aclcnolwedgement of the 
sent text block (always ACKO) or a text 
blocJc from the remote. 

Note: CWRITE is defined for MRJE only when 

specifying both input and output buffers. 



O 
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A. 8 SCCP and SSLC BSC Driver Message Format Word (MFW) 

r ' Ail BSC control characters are inserted into the outgoing data stream 
L by the driver. SYN and block check: character (bcc) sequences are 
always generated. However, the remaining message format Is specified 
by the message format word (MFW), The value of MFW is determined by 
D0PTI0NS.(11:2). F<efer to the DOPTIOMS parameter in the COPEN 
description (section 4,2)« 

MFW (0:1) — Os the text block is to be sent in BSC's transparent mode. 

1= the text block is to be sent in non-transparent mode. 
NOTE: It is the user's responsibility to ensure that 
his text block contains no BSC control characters. 

MFW (1:1) -* 0= there are no intermediate text blocks (itb's) contained 

within the text block. 

1= the text block contains itb's. The length of each itb 
(in f bytes) must precede its block. The length Is a 
16-blt quantity and must begin on a word boundary. The 
last itb must be followed by a delimiter word set to 
all ones. 

MFW (2:1) — This field is significant only if intermediate text 

blocks are to be sent in non*transparent mode, 

0= no SOH/STX character will be inserted after every itb. 

Exception: The STX character is always inserted after 
the header, even it this coincides with the end of an 
itb, 

1= an SOH/STX Character will be injected into the text 
stream after every itb. 

MFW (3:1) -- 0= the text block shall end with an ETX character. 
Is the text Dlock shall end with an ETB character. 

MFW (4:4) «- Reserved for future use; should be set to zero. 

MFW (8:8) -- Length of the header portion of the text block (in > 

bytes). If this field is zero, then there is no header 
portion. 

NOTE: it is the user's responsibility to ensure that 
there are no BSC control characters within the 
header. 

Note that the MFW, itb lengths, and itb delimiter are for the driver's 
Information and are not actually transmitted. The buffer's tcount 
parameter must include the MFW and the itb lengths and delimiter. 
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The use of BSC as the protocol for both types ot boards means that the 
line control mechanism (i.e., state transition) is identical for these 
devices. However, from the above discussion on message formatting, it 
is clear that there exists different message formatting requirements. 

If line control and message formatting were identical for both the SSLC 
and the HSI, then a given CS application program could use either 
device interchangeably (without even recompiling) by simply supplying 
different rCLINE commands with each execution of the program. 

The desirability of this capability suggests that 3000 users either: 

1. Adopt the SCCP and SSLC BSC MFW convention for use with the HSI even 
though the HSI drivers on HP 3000 and HP 2100 do not even recognize 
an MFW, 
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A. 9 Message Formatting 

As was previously mentioned, the HP-supplied CS drivers CSSBSCO and 
CSSBSCl (SSLC), and CSHBSCO (HSl) employ the BSC protocol. Associated 
with the use of any protocol are the concepts of line control and 
message formatting. The HP drivers assume the burden of line control, 
but the user is responsible for message formatting. 

m many communications systems (e.g., IBM's BTAM), the job of message 
formatting requires the user to insert the proper BSC control 
characters at the appropriate points in his text stream prior to 
issuing a write request, and he must remove them from the text received 
from a read request. This is not true of CS/3000. 

The SCCP and SSLC drivers have adopted the convention of using a 
message format word (MFW) which the user optionally supplies as the 
first word of his output buffer on write requests and which governs the 
automatic insertion of the appropriate BSC control characters by the 
driver. On read requests, the driver automatically removes the BSC 
control characters from the text stream and constructs the appropriate 
MFW which optionally becomes the first word of the user's input buffer. 
The INCOUNT and OUTCOUNT parameters of CREAD/CWRITE always include the 
MFW, but the MFW is never actually transmitted across the line. 

The HSI driver, on the other hand, does not use an MFW; all data in the 
output buffer is transmitted across the line. Because the user is 
guaranteed that he is communicating with another HP computer (3000 or 
2100) When he uses the HSI, there is no need for drivers to 
insert/remove special BSC control characters in/from the text stream. /^ 
Hence, there is no MFW interpretation or construction by the HSI \J 
drivers on the 3000 or 2100. Therefore, if the HSI user wants to send 
BSC headers or intermediate text blocks, he may do it using any 
convention that is agreeable to both sender and receiver. 

^.10 User Program Compatibility Between SCCP, SSLC and HSI 
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2, Always use an Implicit MFW with the SCCP and SSLC BSC (reter to 
OOPTIONS in section 4.2). 

If users adopt either of these conventions, their programs will achieve 
a higher degree of flexibility. 
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